Microsoft.IoTCentral (preview:2021-11-01)

2025/10/23 • 16 new, 16 deleted methods

Apps_Get (new)
Description :  Get the metadata of an IoT Central application.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_CreateOrUpdate (new)
Description :  Create or update the metadata of an IoT Central application. The usual pattern to modify a property is to retrieve the IoT Central application metadata and security metadata, and then combine them with the modified values in a new body to update the IoT Central application.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
App:
{
Description: The IoT Central application metadata and security metadata. ,
Required: True ,
}
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
$headers:
{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}
,
$schema:
{
Description: The IoT Central application. ,
}
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (201)

{
$headers:
{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}
,
$schema:
{
Description: The IoT Central application. ,
}
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_Update (new)
Description :  Update the metadata of an IoT Central application.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
AppPatch:
{
Description: The IoT Central application metadata and security metadata. ,
Required: True ,
}
{
tags:
{
Description: Instance tags ,
Required: False ,
}
object ,
sku:
{
Description: A valid instance SKU. ,
Required: False ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (202)

{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
location:
{
Description: URL to query for status of the operation. Returns 202 Accepted while the operation is in progress. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_Delete (new)
Description :  Delete an IoT Central application.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
location:
{
Description: URL to query for status of the operation. Returns 202 Accepted while the operation is in progress. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_ListBySubscription (new)
Description :  Get all IoT Central Applications in a subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/iotApps
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of IoT Central Applications. ,
Required: False ,
}
string ,
value:
{
Description: A list of IoT Central Applications. ,
Required: False ,
}
[
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
PrivateEndpointConnections_Get (new)
Description :  Get the metadata of a private endpoint connection for the IoT Central Application.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
privateEndpointConnectionName:
{
Description: The private endpoint connection name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
PrivateEndpointConnections_Create (new)
Description :  Update a private endpoint connection.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
privateEndpointConnectionName:
{
Description: The private endpoint connection name. ,
Required: True ,
}
string ,
PrivateEndpointConnection:
{
Description: The private endpoint connection metadata. ,
Required: True ,
}
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
$headers:
{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}
,
$schema:
{
Description: The private endpoint connection resource. ,
}
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
PrivateEndpointConnections_Delete (new)
Description :  Deletes a private endpoint connection from the IoT Central Application.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
privateEndpointConnectionName:
{
Description: The private endpoint connection name. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
location:
{
Description: URL to query for status of the operation. Returns 202 Accepted while the operation is in progress. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
PrivateEndpointConnections_List (new)
Description :  Get all private endpoint connections of a IoT Central Application.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}/privateEndpointConnections
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Array of private endpoint connections. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_ListByResourceGroup (new)
Description :  Get all the IoT Central Applications in a resource group.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of IoT Central Applications. ,
Required: False ,
}
string ,
value:
{
Description: A list of IoT Central Applications. ,
Required: False ,
}
[
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_CheckNameAvailability (new)
Description :  Check if an IoT Central application name is available.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkNameAvailability
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
operationInputs:
{
Description: Set the name parameter in the OperationInputs structure to the name of the IoT Central application to check. ,
Required: True ,
}
{
name:
{
Description: The name of the IoT Central application instance to check. ,
Required: True ,
}
string ,
type:
{
Description: The type of the IoT Central resource to query. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: The value which indicates whether the provided name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason for unavailability. ,
Required: False ,
}
string ,
message:
{
Description: The detailed reason message. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_CheckSubdomainAvailability (new)
Description :  Check if an IoT Central application subdomain is available.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkSubdomainAvailability
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
operationInputs:
{
Description: Set the name parameter in the OperationInputs structure to the subdomain of the IoT Central application to check. ,
Required: True ,
}
{
name:
{
Description: The name of the IoT Central application instance to check. ,
Required: True ,
}
string ,
type:
{
Description: The type of the IoT Central resource to query. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: The value which indicates whether the provided name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason for unavailability. ,
Required: False ,
}
string ,
message:
{
Description: The detailed reason message. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_ListTemplates (new)
Description :  Get all available application templates.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/appTemplates
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of IoT Central application templates. ,
Required: False ,
}
string ,
value:
{
Description: A list of IoT Central Application Templates. ,
Required: False ,
}
[
{
manifestId:
{
Description: The ID of the template. ,
Required: False ,
}
string ,
manifestVersion:
{
Description: The version of the template. ,
Required: False ,
}
string ,
name:
{
Description: The name of the template. ,
Required: False ,
}
string ,
title:
{
Description: The title of the template. ,
Required: False ,
}
string ,
order:
{
Description: The order of the template in the templates list. ,
Required: False ,
}
number ,
description:
{
Description: The description of the template. ,
Required: False ,
}
string ,
industry:
{
Description: The industry of the template. ,
Required: False ,
}
string ,
locations:
{
Description: A list of locations that support the template. ,
Required: False ,
}
[
{
id:
{
Description: The ID of the location. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the location. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Operations_List (new)
Description :  Lists all of the available IoT Central Resource Provider operations.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.IoTCentral/operations
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of IoT Central description objects. ,
Required: False ,
}
string ,
value:
{
Description: A list of operations supported by the Microsoft.IoTCentral resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{read | write | action | delete} ,
Required: False ,
}
string ,
display:
{
Description: The object that represents the operation. ,
Required: False ,
}
{
provider:
{
Description: Service provider: Microsoft IoT Central ,
Required: False ,
}
string ,
resource:
{
Description: Resource Type: IoT Central ,
Required: False ,
}
string ,
operation:
{
Description: Name of the operation ,
Required: False ,
}
string ,
description:
{
Description: Friendly description for the operation, ,
Required: False ,
}
string ,
}
,
origin:
{
Description: The intended executor of the operation. ,
Required: False ,
}
string ,
properties:
{
Description: Additional descriptions for the operation. ,
Required: False ,
}
object ,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_Get (removed)
Description :  Get the metadata of an IoT Central application.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_CreateOrUpdate (removed)
Description :  Create or update the metadata of an IoT Central application. The usual pattern to modify a property is to retrieve the IoT Central application metadata and security metadata, and then combine them with the modified values in a new body to update the IoT Central application.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
App:
{
Description: The IoT Central application metadata and security metadata. ,
Required: True ,
}
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
$headers:
{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}
,
$schema:
{
Description: The IoT Central application. ,
}
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (201)

{
$headers:
{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}
,
$schema:
{
Description: The IoT Central application. ,
}
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_Update (removed)
Description :  Update the metadata of an IoT Central application.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
AppPatch:
{
Description: The IoT Central application metadata and security metadata. ,
Required: True ,
}
{
tags:
{
Description: Instance tags ,
Required: False ,
}
object ,
sku:
{
Description: A valid instance SKU. ,
Required: False ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (202)

{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
location:
{
Description: URL to query for status of the operation. Returns 202 Accepted while the operation is in progress. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_Delete (removed)
Description :  Delete an IoT Central application.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
location:
{
Description: URL to query for status of the operation. Returns 202 Accepted while the operation is in progress. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_ListBySubscription (removed)
Description :  Get all IoT Central Applications in a subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/iotApps
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of IoT Central Applications. ,
Required: False ,
}
string ,
value:
{
Description: A list of IoT Central Applications. ,
Required: False ,
}
[
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
PrivateEndpointConnections_Get (removed)
Description :  Get the metadata of a private endpoint connection for the IoT Central Application.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
privateEndpointConnectionName:
{
Description: The private endpoint connection name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
PrivateEndpointConnections_Create (removed)
Description :  Update a private endpoint connection.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
privateEndpointConnectionName:
{
Description: The private endpoint connection name. ,
Required: True ,
}
string ,
PrivateEndpointConnection:
{
Description: The private endpoint connection metadata. ,
Required: True ,
}
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
$headers:
{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}
,
$schema:
{
Description: The private endpoint connection resource. ,
}
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
PrivateEndpointConnections_Delete (removed)
Description :  Deletes a private endpoint connection from the IoT Central Application.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
privateEndpointConnectionName:
{
Description: The private endpoint connection name. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
azure-asyncoperation:
{
Description: URL to query for status of the operation. Returns current state, progress, and error metadata for the operation. ,
}
string ,
location:
{
Description: URL to query for status of the operation. Returns 202 Accepted while the operation is in progress. ,
}
string ,
retry-after:
{
Description: How long the user should wait before making a follow-up request. ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
PrivateEndpointConnections_List (removed)
Description :  Get all private endpoint connections of a IoT Central Application.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}/privateEndpointConnections
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
resourceName:
{
Description: The ARM resource name of the IoT Central application. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Array of private endpoint connections. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_ListByResourceGroup (removed)
Description :  Get all the IoT Central Applications in a resource group.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group that contains the IoT Central application. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of IoT Central Applications. ,
Required: False ,
}
string ,
value:
{
Description: A list of IoT Central Applications. ,
Required: False ,
}
[
{
properties:
{
Description: The common properties of an IoT Central application. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the application. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Updating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
applicationId:
{
Description: The ID of the application. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the application. ,
Required: False ,
}
string ,
subdomain:
{
Description: The subdomain of the application. ,
Required: False ,
}
string ,
template:
{
Description: The ID of the application template, which is a blueprint that defines the characteristics and behaviors of an application. Optional; if not specified, defaults to a blank blueprint and allows the application to be defined from scratch. ,
Required: False ,
}
string ,
state:
{
Description: The current state of the application. ,
Enum:
{
created: No description available. ,
suspended: No description available. ,
}
,
Required: False ,
}
enum ,
publicNetworkAccess:
{
Description: Whether requests from the public network are allowed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
networkRuleSets:
{
Description: Network Rule Set Properties of this IoT Central application. ,
Required: False ,
}
{
applyToDevices:
{
Description: Whether these rules apply for device connectivity to IoT Hub and Device Provisioning service associated with this application. ,
Required: False ,
}
boolean ,
applyToIoTCentral:
{
Description: Whether these rules apply for connectivity via IoT Central web portal and APIs. ,
Required: False ,
}
boolean ,
defaultAction:
{
Description: The default network action to apply. ,
Enum:
{
Allow: No description available. ,
Deny: No description available. ,
}
,
Required: False ,
}
enum ,
ipRules:
{
Description: List of IP rules. ,
Required: False ,
}
[
{
action:
{
Description: The network action for the IP mask. ,
Enum:
{
Allow: No description available. ,
}
,
Required: False ,
}
enum ,
filterName:
{
Description: The readable name of the IP rule. ,
Required: False ,
}
string ,
ipMask:
{
Description: The CIDR block defining the IP range. ,
Required: False ,
}
string ,
}
,
]
,
}
,
privateEndpointConnections:
{
Description: Private endpoint connections created on this IoT Central application. ,
Required: False ,
}
[
{
properties:
{
Description: Resource properties. ,
Required: False ,
}
{
groupIds:
{
Description: The group ids for the private endpoint resource. ,
Required: False ,
}
[
string ,
]
,
privateEndpoint:
{
Description: The private endpoint resource. ,
Required: False ,
}
{
id:
{
Description: The ARM identifier for private endpoint. ,
Required: False ,
}
string ,
}
,
privateLinkServiceConnectionState:
{
Description: A collection of information about the state of the connection between service consumer and provider. ,
Required: True ,
}
{
status:
{
Description: Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: The reason for approval/rejection of the connection. ,
Required: False ,
}
string ,
actionsRequired:
{
Description: A message indicating if changes on the service provider require any updates on the consumer. ,
Required: False ,
}
string ,
}
,
provisioningState:
{
Description: The provisioning state of the private endpoint connection resource. ,
Enum:
{
Succeeded: No description available. ,
Creating: No description available. ,
Deleting: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
}
,
sku:
{
Description: A valid instance SKU. ,
Required: True ,
}
{
name:
{
Description: The name of the SKU. ,
Enum:
{
ST0: No description available. ,
ST1: No description available. ,
ST2: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
identity:
{
Description: The managed identities for the IoT Central application. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (either system assigned, or none). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_CheckNameAvailability (removed)
Description :  Check if an IoT Central application name is available.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkNameAvailability
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
operationInputs:
{
Description: Set the name parameter in the OperationInputs structure to the name of the IoT Central application to check. ,
Required: True ,
}
{
name:
{
Description: The name of the IoT Central application instance to check. ,
Required: True ,
}
string ,
type:
{
Description: The type of the IoT Central resource to query. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: The value which indicates whether the provided name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason for unavailability. ,
Required: False ,
}
string ,
message:
{
Description: The detailed reason message. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_CheckSubdomainAvailability (removed)
Description :  Check if an IoT Central application subdomain is available.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/checkSubdomainAvailability
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
operationInputs:
{
Description: Set the name parameter in the OperationInputs structure to the subdomain of the IoT Central application to check. ,
Required: True ,
}
{
name:
{
Description: The name of the IoT Central application instance to check. ,
Required: True ,
}
string ,
type:
{
Description: The type of the IoT Central resource to query. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: The value which indicates whether the provided name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason for unavailability. ,
Required: False ,
}
string ,
message:
{
Description: The detailed reason message. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Apps_ListTemplates (removed)
Description :  Get all available application templates.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/appTemplates
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The subscription identifier. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of IoT Central application templates. ,
Required: False ,
}
string ,
value:
{
Description: A list of IoT Central Application Templates. ,
Required: False ,
}
[
{
manifestId:
{
Description: The ID of the template. ,
Required: False ,
}
string ,
manifestVersion:
{
Description: The version of the template. ,
Required: False ,
}
string ,
name:
{
Description: The name of the template. ,
Required: False ,
}
string ,
title:
{
Description: The title of the template. ,
Required: False ,
}
string ,
order:
{
Description: The order of the template in the templates list. ,
Required: False ,
}
number ,
description:
{
Description: The description of the template. ,
Required: False ,
}
string ,
industry:
{
Description: The industry of the template. ,
Required: False ,
}
string ,
locations:
{
Description: A list of locations that support the template. ,
Required: False ,
}
[
{
id:
{
Description: The ID of the location. ,
Required: False ,
}
string ,
displayName:
{
Description: The display name of the location. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Operations_List (removed)
Description :  Lists all of the available IoT Central Resource Provider operations.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.IoTCentral/operations
{
api-version:
{
Description: The version of the API. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nextLink:
{
Description: The link used to get the next page of IoT Central description objects. ,
Required: False ,
}
string ,
value:
{
Description: A list of operations supported by the Microsoft.IoTCentral resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{read | write | action | delete} ,
Required: False ,
}
string ,
display:
{
Description: The object that represents the operation. ,
Required: False ,
}
{
provider:
{
Description: Service provider: Microsoft IoT Central ,
Required: False ,
}
string ,
resource:
{
Description: Resource Type: IoT Central ,
Required: False ,
}
string ,
operation:
{
Description: Name of the operation ,
Required: False ,
}
string ,
description:
{
Description: Friendly description for the operation, ,
Required: False ,
}
string ,
}
,
origin:
{
Description: The intended executor of the operation. ,
Required: False ,
}
string ,
properties:
{
Description: Additional descriptions for the operation. ,
Required: False ,
}
object ,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}