SDK for PHP 3.x

Client: Aws\IoTWireless\IoTWirelessClient
Service ID: iotwireless
Version: 2020-11-22

This page describes the parameters and results for the operations of the AWS IoT Wireless (2020-11-22), and shows how to use the Aws\IoTWireless\IoTWirelessClient object to call the described operations. This documentation is specific to the 2020-11-22 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

AssociateAwsAccountWithPartnerAccount ( array $params = [] )
Associates a partner account with your AWS account.
AssociateMulticastGroupWithFuotaTask ( array $params = [] )
Associate a multicast group with a FUOTA task.
AssociateWirelessDeviceWithFuotaTask ( array $params = [] )
Associate a wireless device with a FUOTA task.
AssociateWirelessDeviceWithMulticastGroup ( array $params = [] )
Associates a wireless device with a multicast group.
AssociateWirelessDeviceWithThing ( array $params = [] )
Associates a wireless device with a thing.
AssociateWirelessGatewayWithCertificate ( array $params = [] )
Associates a wireless gateway with a certificate.
AssociateWirelessGatewayWithThing ( array $params = [] )
Associates a wireless gateway with a thing.
CancelMulticastGroupSession ( array $params = [] )
Cancels an existing multicast group session.
CreateDestination ( array $params = [] )
Creates a new destination that maps a device message to an AWS IoT rule.
CreateDeviceProfile ( array $params = [] )
Creates a new device profile.
CreateFuotaTask ( array $params = [] )
Creates a FUOTA task.
CreateMulticastGroup ( array $params = [] )
Creates a multicast group.
CreateNetworkAnalyzerConfiguration ( array $params = [] )
Creates a new network analyzer configuration.
CreateServiceProfile ( array $params = [] )
Creates a new service profile.
CreateWirelessDevice ( array $params = [] )
Provisions a wireless device.
CreateWirelessGateway ( array $params = [] )
Provisions a wireless gateway.
CreateWirelessGatewayTask ( array $params = [] )
Creates a task for a wireless gateway.
CreateWirelessGatewayTaskDefinition ( array $params = [] )
Creates a gateway task definition.
DeleteDestination ( array $params = [] )
Deletes a destination.
DeleteDeviceProfile ( array $params = [] )
Deletes a device profile.
DeleteFuotaTask ( array $params = [] )
Deletes a FUOTA task.
DeleteMulticastGroup ( array $params = [] )
Deletes a multicast group if it is not in use by a fuota task.
DeleteNetworkAnalyzerConfiguration ( array $params = [] )
Deletes a network analyzer configuration.
DeleteQueuedMessages ( array $params = [] )
Remove queued messages from the downlink queue.
DeleteServiceProfile ( array $params = [] )
Deletes a service profile.
DeleteWirelessDevice ( array $params = [] )
Deletes a wireless device.
DeleteWirelessDeviceImportTask ( array $params = [] )
Delete an import task.
DeleteWirelessGateway ( array $params = [] )
Deletes a wireless gateway.
DeleteWirelessGatewayTask ( array $params = [] )
Deletes a wireless gateway task.
DeleteWirelessGatewayTaskDefinition ( array $params = [] )
Deletes a wireless gateway task definition.
DeregisterWirelessDevice ( array $params = [] )
Deregister a wireless device from AWS IoT Wireless.
DisassociateAwsAccountFromPartnerAccount ( array $params = [] )
Disassociates your AWS account from a partner account.
DisassociateMulticastGroupFromFuotaTask ( array $params = [] )
Disassociates a multicast group from a fuota task.
DisassociateWirelessDeviceFromFuotaTask ( array $params = [] )
Disassociates a wireless device from a FUOTA task.
DisassociateWirelessDeviceFromMulticastGroup ( array $params = [] )
Disassociates a wireless device from a multicast group.
DisassociateWirelessDeviceFromThing ( array $params = [] )
Disassociates a wireless device from its currently associated thing.
DisassociateWirelessGatewayFromCertificate ( array $params = [] )
Disassociates a wireless gateway from its currently associated certificate.
DisassociateWirelessGatewayFromThing ( array $params = [] )
Disassociates a wireless gateway from its currently associated thing.
GetDestination ( array $params = [] )
Gets information about a destination.
GetDeviceProfile ( array $params = [] )
Gets information about a device profile.
GetEventConfigurationByResourceTypes ( array $params = [] )
Get the event configuration based on resource types.
GetFuotaTask ( array $params = [] )
Gets information about a FUOTA task.
GetLogLevelsByResourceTypes ( array $params = [] )
Returns current default log levels or log levels by resource types.
GetMetricConfiguration ( array $params = [] )
Get the metric configuration status for this AWS account.
GetMetrics ( array $params = [] )
Get the summary metrics for this AWS account.
GetMulticastGroup ( array $params = [] )
Gets information about a multicast group.
GetMulticastGroupSession ( array $params = [] )
Gets information about a multicast group session.
GetNetworkAnalyzerConfiguration ( array $params = [] )
Get network analyzer configuration.
GetPartnerAccount ( array $params = [] )
Gets information about a partner account.
GetPosition ( array $params = [] )
Get the position information for a given resource.
GetPositionConfiguration ( array $params = [] )
Get position configuration for a given resource.
GetPositionEstimate ( array $params = [] )
Get estimated position information as a payload in GeoJSON format.
GetResourceEventConfiguration ( array $params = [] )
Get the event configuration for a particular resource identifier.
GetResourceLogLevel ( array $params = [] )
Fetches the log-level override, if any, for a given resource-ID and resource-type.
GetResourcePosition ( array $params = [] )
Get the position information for a given wireless device or a wireless gateway resource.
GetServiceEndpoint ( array $params = [] )
Gets the account-specific endpoint for Configuration and Update Server (CUPS) protocol or LoRaWAN Network Server (LNS) connections.
GetServiceProfile ( array $params = [] )
Gets information about a service profile.
GetWirelessDevice ( array $params = [] )
Gets information about a wireless device.
GetWirelessDeviceImportTask ( array $params = [] )
Get information about an import task and count of device onboarding summary information for the import task.
GetWirelessDeviceStatistics ( array $params = [] )
Gets operating information about a wireless device.
GetWirelessGateway ( array $params = [] )
Gets information about a wireless gateway.
GetWirelessGatewayCertificate ( array $params = [] )
Gets the ID of the certificate that is currently associated with a wireless gateway.
GetWirelessGatewayFirmwareInformation ( array $params = [] )
Gets the firmware version and other information about a wireless gateway.
GetWirelessGatewayStatistics ( array $params = [] )
Gets operating information about a wireless gateway.
GetWirelessGatewayTask ( array $params = [] )
Gets information about a wireless gateway task.
GetWirelessGatewayTaskDefinition ( array $params = [] )
Gets information about a wireless gateway task definition.
ListDestinations ( array $params = [] )
Lists the destinations registered to your AWS account.
ListDeviceProfiles ( array $params = [] )
Lists the device profiles registered to your AWS account.
ListDevicesForWirelessDeviceImportTask ( array $params = [] )
List the Sidewalk devices in an import task and their onboarding status.
ListEventConfigurations ( array $params = [] )
List event configurations where at least one event topic has been enabled.
ListFuotaTasks ( array $params = [] )
Lists the FUOTA tasks registered to your AWS account.
ListMulticastGroups ( array $params = [] )
Lists the multicast groups registered to your AWS account.
ListMulticastGroupsByFuotaTask ( array $params = [] )
List all multicast groups associated with a fuota task.
ListNetworkAnalyzerConfigurations ( array $params = [] )
Lists the network analyzer configurations.
ListPartnerAccounts ( array $params = [] )
Lists the partner accounts associated with your AWS account.
ListPositionConfigurations ( array $params = [] )
List position configurations for a given resource, such as positioning solvers.
ListQueuedMessages ( array $params = [] )
List queued messages in the downlink queue.
ListServiceProfiles ( array $params = [] )
Lists the service profiles registered to your AWS account.
ListTagsForResource ( array $params = [] )
Lists the tags (metadata) you have assigned to the resource.
ListWirelessDeviceImportTasks ( array $params = [] )
List wireless devices that have been added to an import task.
ListWirelessDevices ( array $params = [] )
Lists the wireless devices registered to your AWS account.
ListWirelessGatewayTaskDefinitions ( array $params = [] )
List the wireless gateway tasks definitions registered to your AWS account.
ListWirelessGateways ( array $params = [] )
Lists the wireless gateways registered to your AWS account.
PutPositionConfiguration ( array $params = [] )
Put position configuration for a given resource.
PutResourceLogLevel ( array $params = [] )
Sets the log-level override for a resource-ID and resource-type.
ResetAllResourceLogLevels ( array $params = [] )
Removes the log-level overrides for all resources; wireless devices, wireless gateways, and fuota tasks.
ResetResourceLogLevel ( array $params = [] )
Removes the log-level override, if any, for a specific resource-ID and resource-type.
SendDataToMulticastGroup ( array $params = [] )
Sends the specified data to a multicast group.
SendDataToWirelessDevice ( array $params = [] )
Sends a decrypted application data frame to a device.
StartBulkAssociateWirelessDeviceWithMulticastGroup ( array $params = [] )
Starts a bulk association of all qualifying wireless devices with a multicast group.
StartBulkDisassociateWirelessDeviceFromMulticastGroup ( array $params = [] )
Starts a bulk disassociatin of all qualifying wireless devices from a multicast group.
StartFuotaTask ( array $params = [] )
Starts a FUOTA task.
StartMulticastGroupSession ( array $params = [] )
Starts a multicast group session.
StartSingleWirelessDeviceImportTask ( array $params = [] )
Start import task for a single wireless device.
StartWirelessDeviceImportTask ( array $params = [] )
Start import task for provisioning Sidewalk devices in bulk using an S3 CSV file.
TagResource ( array $params = [] )
Adds a tag to a resource.
TestWirelessDevice ( array $params = [] )
Simulates a provisioned device by sending an uplink data payload of Hello.
UntagResource ( array $params = [] )
Removes one or more tags from a resource.
UpdateDestination ( array $params = [] )
Updates properties of a destination.
UpdateEventConfigurationByResourceTypes ( array $params = [] )
Update the event configuration based on resource types.
UpdateFuotaTask ( array $params = [] )
Updates properties of a FUOTA task.
UpdateLogLevelsByResourceTypes ( array $params = [] )
Set default log level, or log levels by resource types.
UpdateMetricConfiguration ( array $params = [] )
Update the summary metric configuration.
UpdateMulticastGroup ( array $params = [] )
Updates properties of a multicast group session.
UpdateNetworkAnalyzerConfiguration ( array $params = [] )
Update network analyzer configuration.
UpdatePartnerAccount ( array $params = [] )
Updates properties of a partner account.
UpdatePosition ( array $params = [] )
Update the position information of a resource.
UpdateResourceEventConfiguration ( array $params = [] )
Update the event configuration for a particular resource identifier.
UpdateResourcePosition ( array $params = [] )
Update the position information of a given wireless device or a wireless gateway resource.
UpdateWirelessDevice ( array $params = [] )
Updates properties of a wireless device.
UpdateWirelessDeviceImportTask ( array $params = [] )
Update an import task to add more devices to the task.
UpdateWirelessGateway ( array $params = [] )
Updates properties of a wireless gateway.

Paginators

Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:

ListDestinations
ListDeviceProfiles
ListFuotaTasks
ListMulticastGroups
ListMulticastGroupsByFuotaTask
ListNetworkAnalyzerConfigurations
ListPositionConfigurations
ListQueuedMessages
ListServiceProfiles
ListWirelessDevices
ListWirelessGateways

Operations

AssociateAwsAccountWithPartnerAccount

$result = $client->associateAwsAccountWithPartnerAccount([/* ... */]);
$promise = $client->associateAwsAccountWithPartnerAccountAsync([/* ... */]);

Associates a partner account with your AWS account.

Parameter Syntax

$result = $client->associateAwsAccountWithPartnerAccount([
    'ClientRequestToken' => '<string>',
    'Sidewalk' => [ // REQUIRED
        'AmazonId' => '<string>',
        'AppServerPrivateKey' => '<string>',
    ],
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

Sidewalk
Required: Yes
Type: SidewalkAccountInfo structure

The Sidewalk account credentials.

Tags
Type: Array of Tag structures

The tags to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Sidewalk' => [
        'AmazonId' => '<string>',
        'AppServerPrivateKey' => '<string>',
    ],
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Sidewalk
Type: SidewalkAccountInfo structure

The Sidewalk account credentials.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

AccessDeniedException:

User does not have permission to perform this action.

AssociateMulticastGroupWithFuotaTask

$result = $client->associateMulticastGroupWithFuotaTask([/* ... */]);
$promise = $client->associateMulticastGroupWithFuotaTaskAsync([/* ... */]);

Associate a multicast group with a FUOTA task.

Parameter Syntax

$result = $client->associateMulticastGroupWithFuotaTask([
    'Id' => '<string>', // REQUIRED
    'MulticastGroupId' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a FUOTA task.

MulticastGroupId
Required: Yes
Type: string

The ID of the multicast group.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

AssociateWirelessDeviceWithFuotaTask

$result = $client->associateWirelessDeviceWithFuotaTask([/* ... */]);
$promise = $client->associateWirelessDeviceWithFuotaTaskAsync([/* ... */]);

Associate a wireless device with a FUOTA task.

Parameter Syntax

$result = $client->associateWirelessDeviceWithFuotaTask([
    'Id' => '<string>', // REQUIRED
    'WirelessDeviceId' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a FUOTA task.

WirelessDeviceId
Required: Yes
Type: string

The ID of the wireless device.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

AssociateWirelessDeviceWithMulticastGroup

$result = $client->associateWirelessDeviceWithMulticastGroup([/* ... */]);
$promise = $client->associateWirelessDeviceWithMulticastGroupAsync([/* ... */]);

Associates a wireless device with a multicast group.

Parameter Syntax

$result = $client->associateWirelessDeviceWithMulticastGroup([
    'Id' => '<string>', // REQUIRED
    'WirelessDeviceId' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

WirelessDeviceId
Required: Yes
Type: string

The ID of the wireless device.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

AssociateWirelessDeviceWithThing

$result = $client->associateWirelessDeviceWithThing([/* ... */]);
$promise = $client->associateWirelessDeviceWithThingAsync([/* ... */]);

Associates a wireless device with a thing.

Parameter Syntax

$result = $client->associateWirelessDeviceWithThing([
    'Id' => '<string>', // REQUIRED
    'ThingArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to update.

ThingArn
Required: Yes
Type: string

The ARN of the thing to associate with the wireless device.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

AssociateWirelessGatewayWithCertificate

$result = $client->associateWirelessGatewayWithCertificate([/* ... */]);
$promise = $client->associateWirelessGatewayWithCertificateAsync([/* ... */]);

Associates a wireless gateway with a certificate.

Parameter Syntax

$result = $client->associateWirelessGatewayWithCertificate([
    'Id' => '<string>', // REQUIRED
    'IotCertificateId' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to update.

IotCertificateId
Required: Yes
Type: string

The ID of the certificate to associate with the wireless gateway.

Result Syntax

[
    'IotCertificateId' => '<string>',
]

Result Details

Members
IotCertificateId
Type: string

The ID of the certificate associated with the wireless gateway.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

AssociateWirelessGatewayWithThing

$result = $client->associateWirelessGatewayWithThing([/* ... */]);
$promise = $client->associateWirelessGatewayWithThingAsync([/* ... */]);

Associates a wireless gateway with a thing.

Parameter Syntax

$result = $client->associateWirelessGatewayWithThing([
    'Id' => '<string>', // REQUIRED
    'ThingArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to update.

ThingArn
Required: Yes
Type: string

The ARN of the thing to associate with the wireless gateway.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

CancelMulticastGroupSession

$result = $client->cancelMulticastGroupSession([/* ... */]);
$promise = $client->cancelMulticastGroupSessionAsync([/* ... */]);

Cancels an existing multicast group session.

Parameter Syntax

$result = $client->cancelMulticastGroupSession([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateDestination

$result = $client->createDestination([/* ... */]);
$promise = $client->createDestinationAsync([/* ... */]);

Creates a new destination that maps a device message to an AWS IoT rule.

Parameter Syntax

$result = $client->createDestination([
    'ClientRequestToken' => '<string>',
    'Description' => '<string>',
    'Expression' => '<string>', // REQUIRED
    'ExpressionType' => 'RuleName|MqttTopic', // REQUIRED
    'Name' => '<string>', // REQUIRED
    'RoleArn' => '<string>', // REQUIRED
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

Description
Type: string

The description of the new resource.

Expression
Required: Yes
Type: string

The rule name or topic rule to send messages to.

ExpressionType
Required: Yes
Type: string

The type of value in Expression.

Name
Required: Yes
Type: string

The name of the new resource.

RoleArn
Required: Yes
Type: string

The ARN of the IAM Role that authorizes the destination.

Tags
Type: Array of Tag structures

The tags to attach to the new destination. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Name' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the new resource.

Name
Type: string

The name of the new resource.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateDeviceProfile

$result = $client->createDeviceProfile([/* ... */]);
$promise = $client->createDeviceProfileAsync([/* ... */]);

Creates a new device profile.

Parameter Syntax

$result = $client->createDeviceProfile([
    'ClientRequestToken' => '<string>',
    'LoRaWAN' => [
        'ClassBTimeout' => <integer>,
        'ClassCTimeout' => <integer>,
        'FactoryPresetFreqsList' => [<integer>, ...],
        'MacVersion' => '<string>',
        'MaxDutyCycle' => <integer>,
        'MaxEirp' => <integer>,
        'PingSlotDr' => <integer>,
        'PingSlotFreq' => <integer>,
        'PingSlotPeriod' => <integer>,
        'RegParamsRevision' => '<string>',
        'RfRegion' => '<string>',
        'RxDataRate2' => <integer>,
        'RxDelay1' => <integer>,
        'RxDrOffset1' => <integer>,
        'RxFreq2' => <integer>,
        'Supports32BitFCnt' => true || false,
        'SupportsClassB' => true || false,
        'SupportsClassC' => true || false,
        'SupportsJoin' => true || false,
    ],
    'Name' => '<string>',
    'Sidewalk' => [
    ],
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

LoRaWAN
Type: LoRaWANDeviceProfile structure

The device profile information to use to create the device profile.

Name
Type: string

The name of the new resource.

Sidewalk
Type: SidewalkCreateDeviceProfile structure

The Sidewalk-related information for creating the Sidewalk device profile.

Tags
Type: Array of Tag structures

The tags to attach to the new device profile. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the new resource.

Id
Type: string

The ID of the new device profile.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateFuotaTask

$result = $client->createFuotaTask([/* ... */]);
$promise = $client->createFuotaTaskAsync([/* ... */]);

Creates a FUOTA task.

Parameter Syntax

$result = $client->createFuotaTask([
    'ClientRequestToken' => '<string>',
    'Description' => '<string>',
    'Descriptor' => '<string>',
    'FirmwareUpdateImage' => '<string>', // REQUIRED
    'FirmwareUpdateRole' => '<string>', // REQUIRED
    'FragmentIntervalMS' => <integer>,
    'FragmentSizeBytes' => <integer>,
    'LoRaWAN' => [
        'RfRegion' => 'EU868|US915|AU915|AS923-1|AS923-2|AS923-3|AS923-4|EU433|CN470|CN779|RU864|KR920|IN865',
    ],
    'Name' => '<string>',
    'RedundancyPercent' => <integer>,
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

Description
Type: string

The description of the new resource.

Descriptor
Type: string

The Descriptor specifies some metadata about the File being transferred using FUOTA e.g. the software version. It is sent transparently to the device. It is a binary field encoded in base64

FirmwareUpdateImage
Required: Yes
Type: string

The S3 URI points to a firmware update image that is to be used with a FUOTA task.

FirmwareUpdateRole
Required: Yes
Type: string

The firmware update role that is to be used with a FUOTA task.

FragmentIntervalMS
Type: int

The interval for sending fragments in milliseconds, rounded to the nearest second.

This interval only determines the timing for when the Cloud sends down the fragments to yor device. There can be a delay for when your device will receive these fragments. This delay depends on the device's class and the communication delay with the cloud.

FragmentSizeBytes
Type: int

The size of each fragment in bytes. This parameter is supported only for FUOTA tasks with multicast groups.

LoRaWAN
Type: LoRaWANFuotaTask structure

The LoRaWAN information used with a FUOTA task.

Name
Type: string

The name of a FUOTA task.

RedundancyPercent
Type: int

The percentage of the added fragments that are redundant. For example, if the size of the firmware image file is 100 bytes and the fragment size is 10 bytes, with RedundancyPercent set to 50(%), the final number of encoded fragments is (100 / 10) + (100 / 10 * 50%) = 15.

Tags
Type: Array of Tag structures

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The arn of a FUOTA task.

Id
Type: string

The ID of a FUOTA task.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateMulticastGroup

$result = $client->createMulticastGroup([/* ... */]);
$promise = $client->createMulticastGroupAsync([/* ... */]);

Creates a multicast group.

Parameter Syntax

$result = $client->createMulticastGroup([
    'ClientRequestToken' => '<string>',
    'Description' => '<string>',
    'LoRaWAN' => [ // REQUIRED
        'DlClass' => 'ClassB|ClassC',
        'ParticipatingGateways' => [
            'GatewayList' => ['<string>', ...],
            'TransmissionInterval' => <integer>,
        ],
        'RfRegion' => 'EU868|US915|AU915|AS923-1|AS923-2|AS923-3|AS923-4|EU433|CN470|CN779|RU864|KR920|IN865',
    ],
    'Name' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

Description
Type: string

The description of the multicast group.

LoRaWAN
Required: Yes
Type: LoRaWANMulticast structure

The LoRaWAN information that is to be used with the multicast group.

Name
Type: string

The name of the multicast group.

Tags
Type: Array of Tag structures

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The arn of the multicast group.

Id
Type: string

The ID of the multicast group.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateNetworkAnalyzerConfiguration

$result = $client->createNetworkAnalyzerConfiguration([/* ... */]);
$promise = $client->createNetworkAnalyzerConfigurationAsync([/* ... */]);

Creates a new network analyzer configuration.

Parameter Syntax

$result = $client->createNetworkAnalyzerConfiguration([
    'ClientRequestToken' => '<string>',
    'Description' => '<string>',
    'MulticastGroups' => ['<string>', ...],
    'Name' => '<string>', // REQUIRED
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'TraceContent' => [
        'LogLevel' => 'INFO|ERROR|DISABLED',
        'MulticastFrameInfo' => 'ENABLED|DISABLED',
        'WirelessDeviceFrameInfo' => 'ENABLED|DISABLED',
    ],
    'WirelessDevices' => ['<string>', ...],
    'WirelessGateways' => ['<string>', ...],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

Description
Type: string

The description of the new resource.

MulticastGroups
Type: Array of strings

Multicast Group resources to add to the network analyzer configruation. Provide the MulticastGroupId of the resource to add in the input array.

Name
Required: Yes
Type: string

Name of the network analyzer configuration.

Tags
Type: Array of Tag structures

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

TraceContent
Type: TraceContent structure

Trace content for your wireless devices, gateways, and multicast groups.

WirelessDevices
Type: Array of strings

Wireless device resources to add to the network analyzer configuration. Provide the WirelessDeviceId of the resource to add in the input array.

WirelessGateways
Type: Array of strings

Wireless gateway resources to add to the network analyzer configuration. Provide the WirelessGatewayId of the resource to add in the input array.

Result Syntax

[
    'Arn' => '<string>',
    'Name' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the new resource.

Name
Type: string

Name of the network analyzer configuration.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateServiceProfile

$result = $client->createServiceProfile([/* ... */]);
$promise = $client->createServiceProfileAsync([/* ... */]);

Creates a new service profile.

Parameter Syntax

$result = $client->createServiceProfile([
    'ClientRequestToken' => '<string>',
    'LoRaWAN' => [
        'AddGwMetadata' => true || false,
        'DrMax' => <integer>,
        'DrMin' => <integer>,
        'PrAllowed' => true || false,
        'RaAllowed' => true || false,
    ],
    'Name' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

LoRaWAN
Type: LoRaWANServiceProfile structure

The service profile information to use to create the service profile.

Name
Type: string

The name of the new resource.

Tags
Type: Array of Tag structures

The tags to attach to the new service profile. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the new resource.

Id
Type: string

The ID of the new service profile.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateWirelessDevice

$result = $client->createWirelessDevice([/* ... */]);
$promise = $client->createWirelessDeviceAsync([/* ... */]);

Provisions a wireless device.

Parameter Syntax

$result = $client->createWirelessDevice([
    'ClientRequestToken' => '<string>',
    'Description' => '<string>',
    'DestinationName' => '<string>', // REQUIRED
    'LoRaWAN' => [
        'AbpV1_0_x' => [
            'DevAddr' => '<string>',
            'FCntStart' => <integer>,
            'SessionKeys' => [
                'AppSKey' => '<string>',
                'NwkSKey' => '<string>',
            ],
        ],
        'AbpV1_1' => [
            'DevAddr' => '<string>',
            'FCntStart' => <integer>,
            'SessionKeys' => [
                'AppSKey' => '<string>',
                'FNwkSIntKey' => '<string>',
                'NwkSEncKey' => '<string>',
                'SNwkSIntKey' => '<string>',
            ],
        ],
        'DevEui' => '<string>',
        'DeviceProfileId' => '<string>',
        'FPorts' => [
            'Applications' => [
                [
                    'DestinationName' => '<string>',
                    'FPort' => <integer>,
                    'Type' => 'SemtechGeolocation',
                ],
                // ...
            ],
            'ClockSync' => <integer>,
            'Fuota' => <integer>,
            'Multicast' => <integer>,
            'Positioning' => [
                'ClockSync' => <integer>,
                'Gnss' => <integer>,
                'Stream' => <integer>,
            ],
        ],
        'OtaaV1_0_x' => [
            'AppEui' => '<string>',
            'AppKey' => '<string>',
            'GenAppKey' => '<string>',
            'JoinEui' => '<string>',
        ],
        'OtaaV1_1' => [
            'AppKey' => '<string>',
            'JoinEui' => '<string>',
            'NwkKey' => '<string>',
        ],
        'ServiceProfileId' => '<string>',
    ],
    'Name' => '<string>',
    'Positioning' => 'Enabled|Disabled',
    'Sidewalk' => [
        'DeviceProfileId' => '<string>',
    ],
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'Type' => 'Sidewalk|LoRaWAN', // REQUIRED
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

Description
Type: string

The description of the new resource.

DestinationName
Required: Yes
Type: string

The name of the destination to assign to the new wireless device.

LoRaWAN
Type: LoRaWANDevice structure

The device configuration information to use to create the wireless device.

Name
Type: string

The name of the new resource.

Positioning
Type: string

FPort values for the GNSS, stream, and ClockSync functions of the positioning information.

Sidewalk

The device configuration information to use to create the Sidewalk device.

Tags
Type: Array of Tag structures

The tags to attach to the new wireless device. Tags are metadata that you can use to manage a resource.

Type
Required: Yes
Type: string

The wireless device type.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the new resource.

Id
Type: string

The ID of the new wireless device.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateWirelessGateway

$result = $client->createWirelessGateway([/* ... */]);
$promise = $client->createWirelessGatewayAsync([/* ... */]);

Provisions a wireless gateway.

When provisioning a wireless gateway, you might run into duplication errors for the following reasons.

  • If you specify a GatewayEui value that already exists.

  • If you used a ClientRequestToken with the same parameters within the last 10 minutes.

To avoid this error, make sure that you use unique identifiers and parameters for each request within the specified time period.

Parameter Syntax

$result = $client->createWirelessGateway([
    'ClientRequestToken' => '<string>',
    'Description' => '<string>',
    'LoRaWAN' => [ // REQUIRED
        'Beaconing' => [
            'DataRate' => <integer>,
            'Frequencies' => [<integer>, ...],
        ],
        'GatewayEui' => '<string>',
        'JoinEuiFilters' => [
            ['<string>', ...],
            // ...
        ],
        'MaxEirp' => <float>,
        'NetIdFilters' => ['<string>', ...],
        'RfRegion' => '<string>',
        'SubBands' => [<integer>, ...],
    ],
    'Name' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

Description
Type: string

The description of the new resource.

LoRaWAN
Required: Yes
Type: LoRaWANGateway structure

The gateway configuration information to use to create the wireless gateway.

Name
Type: string

The name of the new resource.

Tags
Type: Array of Tag structures

The tags to attach to the new wireless gateway. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the new resource.

Id
Type: string

The ID of the new wireless gateway.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateWirelessGatewayTask

$result = $client->createWirelessGatewayTask([/* ... */]);
$promise = $client->createWirelessGatewayTaskAsync([/* ... */]);

Creates a task for a wireless gateway.

Parameter Syntax

$result = $client->createWirelessGatewayTask([
    'Id' => '<string>', // REQUIRED
    'WirelessGatewayTaskDefinitionId' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to update.

WirelessGatewayTaskDefinitionId
Required: Yes
Type: string

The ID of the WirelessGatewayTaskDefinition.

Result Syntax

[
    'Status' => 'PENDING|IN_PROGRESS|FIRST_RETRY|SECOND_RETRY|COMPLETED|FAILED',
    'WirelessGatewayTaskDefinitionId' => '<string>',
]

Result Details

Members
Status
Type: string

The status of the request.

WirelessGatewayTaskDefinitionId
Type: string

The ID of the WirelessGatewayTaskDefinition.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

CreateWirelessGatewayTaskDefinition

$result = $client->createWirelessGatewayTaskDefinition([/* ... */]);
$promise = $client->createWirelessGatewayTaskDefinitionAsync([/* ... */]);

Creates a gateway task definition.

Parameter Syntax

$result = $client->createWirelessGatewayTaskDefinition([
    'AutoCreateTasks' => true || false, // REQUIRED
    'ClientRequestToken' => '<string>',
    'Name' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'Update' => [
        'LoRaWAN' => [
            'CurrentVersion' => [
                'Model' => '<string>',
                'PackageVersion' => '<string>',
                'Station' => '<string>',
            ],
            'SigKeyCrc' => <integer>,
            'UpdateSignature' => '<string>',
            'UpdateVersion' => [
                'Model' => '<string>',
                'PackageVersion' => '<string>',
                'Station' => '<string>',
            ],
        ],
        'UpdateDataRole' => '<string>',
        'UpdateDataSource' => '<string>',
    ],
]);

Parameter Details

Members
AutoCreateTasks
Required: Yes
Type: boolean

Whether to automatically create tasks using this task definition for all gateways with the specified current version. If false, the task must me created by calling CreateWirelessGatewayTask.

ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

Name
Type: string

The name of the new resource.

Tags
Type: Array of Tag structures

The tags to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Update

Information about the gateways to update.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Id
Type: string

The ID of the new wireless gateway task definition.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteDestination

$result = $client->deleteDestination([/* ... */]);
$promise = $client->deleteDestinationAsync([/* ... */]);

Deletes a destination.

Parameter Syntax

$result = $client->deleteDestination([
    'Name' => '<string>', // REQUIRED
]);

Parameter Details

Members
Name
Required: Yes
Type: string

The name of the resource to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteDeviceProfile

$result = $client->deleteDeviceProfile([/* ... */]);
$promise = $client->deleteDeviceProfileAsync([/* ... */]);

Deletes a device profile.

Parameter Syntax

$result = $client->deleteDeviceProfile([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteFuotaTask

$result = $client->deleteFuotaTask([/* ... */]);
$promise = $client->deleteFuotaTaskAsync([/* ... */]);

Deletes a FUOTA task.

Parameter Syntax

$result = $client->deleteFuotaTask([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a FUOTA task.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteMulticastGroup

$result = $client->deleteMulticastGroup([/* ... */]);
$promise = $client->deleteMulticastGroupAsync([/* ... */]);

Deletes a multicast group if it is not in use by a fuota task.

Parameter Syntax

$result = $client->deleteMulticastGroup([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteNetworkAnalyzerConfiguration

$result = $client->deleteNetworkAnalyzerConfiguration([/* ... */]);
$promise = $client->deleteNetworkAnalyzerConfigurationAsync([/* ... */]);

Deletes a network analyzer configuration.

Parameter Syntax

$result = $client->deleteNetworkAnalyzerConfiguration([
    'ConfigurationName' => '<string>', // REQUIRED
]);

Parameter Details

Members
ConfigurationName
Required: Yes
Type: string

Name of the network analyzer configuration.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteQueuedMessages

$result = $client->deleteQueuedMessages([/* ... */]);
$promise = $client->deleteQueuedMessagesAsync([/* ... */]);

Remove queued messages from the downlink queue.

Parameter Syntax

$result = $client->deleteQueuedMessages([
    'Id' => '<string>', // REQUIRED
    'MessageId' => '<string>', // REQUIRED
    'WirelessDeviceType' => 'Sidewalk|LoRaWAN',
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a given wireless device for which downlink messages will be deleted.

MessageId
Required: Yes
Type: string

If message ID is "*", it cleares the entire downlink queue for a given device, specified by the wireless device ID. Otherwise, the downlink message with the specified message ID will be deleted.

WirelessDeviceType
Type: string

The wireless device type, which can be either Sidewalk or LoRaWAN.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

AccessDeniedException:

User does not have permission to perform this action.

DeleteServiceProfile

$result = $client->deleteServiceProfile([/* ... */]);
$promise = $client->deleteServiceProfileAsync([/* ... */]);

Deletes a service profile.

Parameter Syntax

$result = $client->deleteServiceProfile([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteWirelessDevice

$result = $client->deleteWirelessDevice([/* ... */]);
$promise = $client->deleteWirelessDeviceAsync([/* ... */]);

Deletes a wireless device.

Parameter Syntax

$result = $client->deleteWirelessDevice([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteWirelessDeviceImportTask

$result = $client->deleteWirelessDeviceImportTask([/* ... */]);
$promise = $client->deleteWirelessDeviceImportTaskAsync([/* ... */]);

Delete an import task.

Parameter Syntax

$result = $client->deleteWirelessDeviceImportTask([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The unique identifier of the import task to be deleted.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteWirelessGateway

$result = $client->deleteWirelessGateway([/* ... */]);
$promise = $client->deleteWirelessGatewayAsync([/* ... */]);

Deletes a wireless gateway.

When deleting a wireless gateway, you might run into duplication errors for the following reasons.

  • If you specify a GatewayEui value that already exists.

  • If you used a ClientRequestToken with the same parameters within the last 10 minutes.

To avoid this error, make sure that you use unique identifiers and parameters for each request within the specified time period.

Parameter Syntax

$result = $client->deleteWirelessGateway([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteWirelessGatewayTask

$result = $client->deleteWirelessGatewayTask([/* ... */]);
$promise = $client->deleteWirelessGatewayTaskAsync([/* ... */]);

Deletes a wireless gateway task.

Parameter Syntax

$result = $client->deleteWirelessGatewayTask([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeleteWirelessGatewayTaskDefinition

$result = $client->deleteWirelessGatewayTaskDefinition([/* ... */]);
$promise = $client->deleteWirelessGatewayTaskDefinitionAsync([/* ... */]);

Deletes a wireless gateway task definition. Deleting this task definition does not affect tasks that are currently in progress.

Parameter Syntax

$result = $client->deleteWirelessGatewayTaskDefinition([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DeregisterWirelessDevice

$result = $client->deregisterWirelessDevice([/* ... */]);
$promise = $client->deregisterWirelessDeviceAsync([/* ... */]);

Deregister a wireless device from AWS IoT Wireless.

Parameter Syntax

$result = $client->deregisterWirelessDevice([
    'Identifier' => '<string>', // REQUIRED
    'WirelessDeviceType' => 'Sidewalk|LoRaWAN',
]);

Parameter Details

Members
Identifier
Required: Yes
Type: string

The identifier of the wireless device to deregister from AWS IoT Wireless.

WirelessDeviceType
Type: string

The type of wireless device to deregister from AWS IoT Wireless, which can be LoRaWAN or Sidewalk.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DisassociateAwsAccountFromPartnerAccount

$result = $client->disassociateAwsAccountFromPartnerAccount([/* ... */]);
$promise = $client->disassociateAwsAccountFromPartnerAccountAsync([/* ... */]);

Disassociates your AWS account from a partner account. If PartnerAccountId and PartnerType are null, disassociates your AWS account from all partner accounts.

Parameter Syntax

$result = $client->disassociateAwsAccountFromPartnerAccount([
    'PartnerAccountId' => '<string>', // REQUIRED
    'PartnerType' => 'Sidewalk', // REQUIRED
]);

Parameter Details

Members
PartnerAccountId
Required: Yes
Type: string

The partner account ID to disassociate from the AWS account.

PartnerType
Required: Yes
Type: string

The partner type.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DisassociateMulticastGroupFromFuotaTask

$result = $client->disassociateMulticastGroupFromFuotaTask([/* ... */]);
$promise = $client->disassociateMulticastGroupFromFuotaTaskAsync([/* ... */]);

Disassociates a multicast group from a fuota task.

Parameter Syntax

$result = $client->disassociateMulticastGroupFromFuotaTask([
    'Id' => '<string>', // REQUIRED
    'MulticastGroupId' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a FUOTA task.

MulticastGroupId
Required: Yes
Type: string

The ID of the multicast group.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

DisassociateWirelessDeviceFromFuotaTask

$result = $client->disassociateWirelessDeviceFromFuotaTask([/* ... */]);
$promise = $client->disassociateWirelessDeviceFromFuotaTaskAsync([/* ... */]);

Disassociates a wireless device from a FUOTA task.

Parameter Syntax

$result = $client->disassociateWirelessDeviceFromFuotaTask([
    'Id' => '<string>', // REQUIRED
    'WirelessDeviceId' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a FUOTA task.

WirelessDeviceId
Required: Yes
Type: string

The ID of the wireless device.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

DisassociateWirelessDeviceFromMulticastGroup

$result = $client->disassociateWirelessDeviceFromMulticastGroup([/* ... */]);
$promise = $client->disassociateWirelessDeviceFromMulticastGroupAsync([/* ... */]);

Disassociates a wireless device from a multicast group.

Parameter Syntax

$result = $client->disassociateWirelessDeviceFromMulticastGroup([
    'Id' => '<string>', // REQUIRED
    'WirelessDeviceId' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

WirelessDeviceId
Required: Yes
Type: string

The ID of the wireless device.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

DisassociateWirelessDeviceFromThing

$result = $client->disassociateWirelessDeviceFromThing([/* ... */]);
$promise = $client->disassociateWirelessDeviceFromThingAsync([/* ... */]);

Disassociates a wireless device from its currently associated thing.

Parameter Syntax

$result = $client->disassociateWirelessDeviceFromThing([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to update.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

DisassociateWirelessGatewayFromCertificate

$result = $client->disassociateWirelessGatewayFromCertificate([/* ... */]);
$promise = $client->disassociateWirelessGatewayFromCertificateAsync([/* ... */]);

Disassociates a wireless gateway from its currently associated certificate.

Parameter Syntax

$result = $client->disassociateWirelessGatewayFromCertificate([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to update.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

DisassociateWirelessGatewayFromThing

$result = $client->disassociateWirelessGatewayFromThing([/* ... */]);
$promise = $client->disassociateWirelessGatewayFromThingAsync([/* ... */]);

Disassociates a wireless gateway from its currently associated thing.

Parameter Syntax

$result = $client->disassociateWirelessGatewayFromThing([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to update.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

GetDestination

$result = $client->getDestination([/* ... */]);
$promise = $client->getDestinationAsync([/* ... */]);

Gets information about a destination.

Parameter Syntax

$result = $client->getDestination([
    'Name' => '<string>', // REQUIRED
]);

Parameter Details

Members
Name
Required: Yes
Type: string

The name of the resource to get.

Result Syntax

[
    'Arn' => '<string>',
    'Description' => '<string>',
    'Expression' => '<string>',
    'ExpressionType' => 'RuleName|MqttTopic',
    'Name' => '<string>',
    'RoleArn' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Description
Type: string

The description of the resource.

Expression
Type: string

The rule name or topic rule to send messages to.

ExpressionType
Type: string

The type of value in Expression.

Name
Type: string

The name of the resource.

RoleArn
Type: string

The ARN of the IAM Role that authorizes the destination.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetDeviceProfile

$result = $client->getDeviceProfile([/* ... */]);
$promise = $client->getDeviceProfileAsync([/* ... */]);

Gets information about a device profile.

Parameter Syntax

$result = $client->getDeviceProfile([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to get.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
    'LoRaWAN' => [
        'ClassBTimeout' => <integer>,
        'ClassCTimeout' => <integer>,
        'FactoryPresetFreqsList' => [<integer>, ...],
        'MacVersion' => '<string>',
        'MaxDutyCycle' => <integer>,
        'MaxEirp' => <integer>,
        'PingSlotDr' => <integer>,
        'PingSlotFreq' => <integer>,
        'PingSlotPeriod' => <integer>,
        'RegParamsRevision' => '<string>',
        'RfRegion' => '<string>',
        'RxDataRate2' => <integer>,
        'RxDelay1' => <integer>,
        'RxDrOffset1' => <integer>,
        'RxFreq2' => <integer>,
        'Supports32BitFCnt' => true || false,
        'SupportsClassB' => true || false,
        'SupportsClassC' => true || false,
        'SupportsJoin' => true || false,
    ],
    'Name' => '<string>',
    'Sidewalk' => [
        'ApplicationServerPublicKey' => '<string>',
        'DakCertificateMetadata' => [
            [
                'ApId' => '<string>',
                'CertificateId' => '<string>',
                'DeviceTypeId' => '<string>',
                'FactorySupport' => true || false,
                'MaxAllowedSignature' => <integer>,
            ],
            // ...
        ],
        'QualificationStatus' => true || false,
    ],
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Id
Type: string

The ID of the device profile.

LoRaWAN
Type: LoRaWANDeviceProfile structure

Information about the device profile.

Name
Type: string

The name of the resource.

Sidewalk
Type: SidewalkGetDeviceProfile structure

Information about the Sidewalk parameters in the device profile.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetEventConfigurationByResourceTypes

$result = $client->getEventConfigurationByResourceTypes([/* ... */]);
$promise = $client->getEventConfigurationByResourceTypesAsync([/* ... */]);

Get the event configuration based on resource types.

Parameter Syntax

$result = $client->getEventConfigurationByResourceTypes([
]);

Parameter Details

Members

Result Syntax

[
    'ConnectionStatus' => [
        'LoRaWAN' => [
            'WirelessGatewayEventTopic' => 'Enabled|Disabled',
        ],
    ],
    'DeviceRegistrationState' => [
        'Sidewalk' => [
            'WirelessDeviceEventTopic' => 'Enabled|Disabled',
        ],
    ],
    'Join' => [
        'LoRaWAN' => [
            'WirelessDeviceEventTopic' => 'Enabled|Disabled',
        ],
    ],
    'MessageDeliveryStatus' => [
        'Sidewalk' => [
            'WirelessDeviceEventTopic' => 'Enabled|Disabled',
        ],
    ],
    'Proximity' => [
        'Sidewalk' => [
            'WirelessDeviceEventTopic' => 'Enabled|Disabled',
        ],
    ],
]

Result Details

Members
ConnectionStatus

Resource type event configuration for the connection status event.

DeviceRegistrationState

Resource type event configuration for the device registration state event.

Join

Resource type event configuration for the join event.

MessageDeliveryStatus

Resource type event configuration object for the message delivery status event.

Proximity

Resource type event configuration for the proximity event.

Errors

AccessDeniedException:

User does not have permission to perform this action.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

GetFuotaTask

$result = $client->getFuotaTask([/* ... */]);
$promise = $client->getFuotaTaskAsync([/* ... */]);

Gets information about a FUOTA task.

Parameter Syntax

$result = $client->getFuotaTask([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a FUOTA task.

Result Syntax

[
    'Arn' => '<string>',
    'CreatedAt' => <DateTime>,
    'Description' => '<string>',
    'Descriptor' => '<string>',
    'FirmwareUpdateImage' => '<string>',
    'FirmwareUpdateRole' => '<string>',
    'FragmentIntervalMS' => <integer>,
    'FragmentSizeBytes' => <integer>,
    'Id' => '<string>',
    'LoRaWAN' => [
        'RfRegion' => '<string>',
        'StartTime' => <DateTime>,
    ],
    'Name' => '<string>',
    'RedundancyPercent' => <integer>,
    'Status' => 'Pending|FuotaSession_Waiting|In_FuotaSession|FuotaDone|Delete_Waiting',
]

Result Details

Members
Arn
Type: string

The arn of a FUOTA task.

CreatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

Created at timestamp for the resource.

Description
Type: string

The description of the new resource.

Descriptor
Type: string

The Descriptor specifies some metadata about the File being transferred using FUOTA e.g. the software version. It is sent transparently to the device. It is a binary field encoded in base64

FirmwareUpdateImage
Type: string

The S3 URI points to a firmware update image that is to be used with a FUOTA task.

FirmwareUpdateRole
Type: string

The firmware update role that is to be used with a FUOTA task.

FragmentIntervalMS
Type: int

The interval for sending fragments in milliseconds, rounded to the nearest second.

This interval only determines the timing for when the Cloud sends down the fragments to yor device. There can be a delay for when your device will receive these fragments. This delay depends on the device's class and the communication delay with the cloud.

FragmentSizeBytes
Type: int

The size of each fragment in bytes. This parameter is supported only for FUOTA tasks with multicast groups.

Id
Type: string

The ID of a FUOTA task.

LoRaWAN
Type: LoRaWANFuotaTaskGetInfo structure

The LoRaWAN information returned from getting a FUOTA task.

Name
Type: string

The name of a FUOTA task.

RedundancyPercent
Type: int

The percentage of the added fragments that are redundant. For example, if the size of the firmware image file is 100 bytes and the fragment size is 10 bytes, with RedundancyPercent set to 50(%), the final number of encoded fragments is (100 / 10) + (100 / 10 * 50%) = 15.

Status
Type: string

The status of a FUOTA task.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetLogLevelsByResourceTypes

$result = $client->getLogLevelsByResourceTypes([/* ... */]);
$promise = $client->getLogLevelsByResourceTypesAsync([/* ... */]);

Returns current default log levels or log levels by resource types. Based on resource types, log levels can be for wireless device log options or wireless gateway log options.

Parameter Syntax

$result = $client->getLogLevelsByResourceTypes([
]);

Parameter Details

Members

Result Syntax

[
    'DefaultLogLevel' => 'INFO|ERROR|DISABLED',
    'FuotaTaskLogOptions' => [
        [
            'Events' => [
                [
                    'Event' => 'Fuota',
                    'LogLevel' => 'INFO|ERROR|DISABLED',
                ],
                // ...
            ],
            'LogLevel' => 'INFO|ERROR|DISABLED',
            'Type' => 'LoRaWAN',
        ],
        // ...
    ],
    'WirelessDeviceLogOptions' => [
        [
            'Events' => [
                [
                    'Event' => 'Join|Rejoin|Uplink_Data|Downlink_Data|Registration',
                    'LogLevel' => 'INFO|ERROR|DISABLED',
                ],
                // ...
            ],
            'LogLevel' => 'INFO|ERROR|DISABLED',
            'Type' => 'Sidewalk|LoRaWAN',
        ],
        // ...
    ],
    'WirelessGatewayLogOptions' => [
        [
            'Events' => [
                [
                    'Event' => 'CUPS_Request|Certificate',
                    'LogLevel' => 'INFO|ERROR|DISABLED',
                ],
                // ...
            ],
            'LogLevel' => 'INFO|ERROR|DISABLED',
            'Type' => 'LoRaWAN',
        ],
        // ...
    ],
]

Result Details

Members
DefaultLogLevel
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

FuotaTaskLogOptions
Type: Array of FuotaTaskLogOption structures

The list of fuota task log options.

WirelessDeviceLogOptions
Type: Array of WirelessDeviceLogOption structures

The list of wireless device log options.

WirelessGatewayLogOptions
Type: Array of WirelessGatewayLogOption structures

The list of wireless gateway log options.

Errors

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ValidationException:

The input did not meet the specified constraints.

GetMetricConfiguration

$result = $client->getMetricConfiguration([/* ... */]);
$promise = $client->getMetricConfigurationAsync([/* ... */]);

Get the metric configuration status for this AWS account.

Parameter Syntax

$result = $client->getMetricConfiguration([
]);

Parameter Details

Members

Result Syntax

[
    'SummaryMetric' => [
        'Status' => 'Enabled|Disabled',
    ],
]

Result Details

Members
SummaryMetric
Type: SummaryMetricConfiguration structure

The configuration status of the AWS account for summary metric aggregation.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetMetrics

$result = $client->getMetrics([/* ... */]);
$promise = $client->getMetricsAsync([/* ... */]);

Get the summary metrics for this AWS account.

Parameter Syntax

$result = $client->getMetrics([
    'SummaryMetricQueries' => [
        [
            'AggregationPeriod' => 'OneHour|OneDay|OneWeek',
            'Dimensions' => [
                [
                    'name' => 'DeviceId|GatewayId',
                    'value' => '<string>',
                ],
                // ...
            ],
            'EndTimestamp' => <integer || string || DateTime>,
            'MetricName' => 'DeviceRSSI|DeviceSNR|DeviceRoamingRSSI|DeviceRoamingSNR|DeviceUplinkCount|DeviceDownlinkCount|DeviceUplinkLostCount|DeviceUplinkLostRate|DeviceJoinRequestCount|DeviceJoinAcceptCount|DeviceRoamingUplinkCount|DeviceRoamingDownlinkCount|GatewayUpTime|GatewayDownTime|GatewayRSSI|GatewaySNR|GatewayUplinkCount|GatewayDownlinkCount|GatewayJoinRequestCount|GatewayJoinAcceptCount|AwsAccountUplinkCount|AwsAccountDownlinkCount|AwsAccountUplinkLostCount|AwsAccountUplinkLostRate|AwsAccountJoinRequestCount|AwsAccountJoinAcceptCount|AwsAccountRoamingUplinkCount|AwsAccountRoamingDownlinkCount|AwsAccountDeviceCount|AwsAccountGatewayCount|AwsAccountActiveDeviceCount|AwsAccountActiveGatewayCount',
            'QueryId' => '<string>',
            'StartTimestamp' => <integer || string || DateTime>,
        ],
        // ...
    ],
]);

Parameter Details

Members
SummaryMetricQueries
Type: Array of SummaryMetricQuery structures

The list of queries to retrieve the summary metrics.

Result Syntax

[
    'SummaryMetricQueryResults' => [
        [
            'AggregationPeriod' => 'OneHour|OneDay|OneWeek',
            'Dimensions' => [
                [
                    'name' => 'DeviceId|GatewayId',
                    'value' => '<string>',
                ],
                // ...
            ],
            'EndTimestamp' => <DateTime>,
            'Error' => '<string>',
            'MetricName' => 'DeviceRSSI|DeviceSNR|DeviceRoamingRSSI|DeviceRoamingSNR|DeviceUplinkCount|DeviceDownlinkCount|DeviceUplinkLostCount|DeviceUplinkLostRate|DeviceJoinRequestCount|DeviceJoinAcceptCount|DeviceRoamingUplinkCount|DeviceRoamingDownlinkCount|GatewayUpTime|GatewayDownTime|GatewayRSSI|GatewaySNR|GatewayUplinkCount|GatewayDownlinkCount|GatewayJoinRequestCount|GatewayJoinAcceptCount|AwsAccountUplinkCount|AwsAccountDownlinkCount|AwsAccountUplinkLostCount|AwsAccountUplinkLostRate|AwsAccountJoinRequestCount|AwsAccountJoinAcceptCount|AwsAccountRoamingUplinkCount|AwsAccountRoamingDownlinkCount|AwsAccountDeviceCount|AwsAccountGatewayCount|AwsAccountActiveDeviceCount|AwsAccountActiveGatewayCount',
            'QueryId' => '<string>',
            'QueryStatus' => 'Succeeded|Failed',
            'StartTimestamp' => <DateTime>,
            'Timestamps' => [<DateTime>, ...],
            'Unit' => '<string>',
            'Values' => [
                [
                    'Avg' => <float>,
                    'Max' => <float>,
                    'Min' => <float>,
                    'P90' => <float>,
                    'Std' => <float>,
                    'Sum' => <float>,
                ],
                // ...
            ],
        ],
        // ...
    ],
]

Result Details

Members
SummaryMetricQueryResults
Type: Array of SummaryMetricQueryResult structures

The list of summary metrics that were retrieved.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetMulticastGroup

$result = $client->getMulticastGroup([/* ... */]);
$promise = $client->getMulticastGroupAsync([/* ... */]);

Gets information about a multicast group.

Parameter Syntax

$result = $client->getMulticastGroup([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

Result Syntax

[
    'Arn' => '<string>',
    'CreatedAt' => <DateTime>,
    'Description' => '<string>',
    'Id' => '<string>',
    'LoRaWAN' => [
        'DlClass' => 'ClassB|ClassC',
        'NumberOfDevicesInGroup' => <integer>,
        'NumberOfDevicesRequested' => <integer>,
        'ParticipatingGateways' => [
            'GatewayList' => ['<string>', ...],
            'TransmissionInterval' => <integer>,
        ],
        'RfRegion' => 'EU868|US915|AU915|AS923-1|AS923-2|AS923-3|AS923-4|EU433|CN470|CN779|RU864|KR920|IN865',
    ],
    'Name' => '<string>',
    'Status' => '<string>',
]

Result Details

Members
Arn
Type: string

The arn of the multicast group.

CreatedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

Created at timestamp for the resource.

Description
Type: string

The description of the new resource.

Id
Type: string

The ID of the multicast group.

LoRaWAN
Type: LoRaWANMulticastGet structure

The LoRaWAN information that is to be returned from getting multicast group information.

Name
Type: string

The name of the multicast group.

Status
Type: string

The status of the multicast group.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetMulticastGroupSession

$result = $client->getMulticastGroupSession([/* ... */]);
$promise = $client->getMulticastGroupSessionAsync([/* ... */]);

Gets information about a multicast group session.

Parameter Syntax

$result = $client->getMulticastGroupSession([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

Result Syntax

[
    'LoRaWAN' => [
        'DlDr' => <integer>,
        'DlFreq' => <integer>,
        'PingSlotPeriod' => <integer>,
        'SessionStartTime' => <DateTime>,
        'SessionTimeout' => <integer>,
    ],
]

Result Details

Members
LoRaWAN
Type: LoRaWANMulticastSession structure

The LoRaWAN information used with the multicast session.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetNetworkAnalyzerConfiguration

$result = $client->getNetworkAnalyzerConfiguration([/* ... */]);
$promise = $client->getNetworkAnalyzerConfigurationAsync([/* ... */]);

Get network analyzer configuration.

Parameter Syntax

$result = $client->getNetworkAnalyzerConfiguration([
    'ConfigurationName' => '<string>', // REQUIRED
]);

Parameter Details

Members
ConfigurationName
Required: Yes
Type: string

Name of the network analyzer configuration.

Result Syntax

[
    'Arn' => '<string>',
    'Description' => '<string>',
    'MulticastGroups' => ['<string>', ...],
    'Name' => '<string>',
    'TraceContent' => [
        'LogLevel' => 'INFO|ERROR|DISABLED',
        'MulticastFrameInfo' => 'ENABLED|DISABLED',
        'WirelessDeviceFrameInfo' => 'ENABLED|DISABLED',
    ],
    'WirelessDevices' => ['<string>', ...],
    'WirelessGateways' => ['<string>', ...],
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the new resource.

Description
Type: string

The description of the new resource.

MulticastGroups
Type: Array of strings

List of multicast group resources that have been added to the network analyzer configuration.

Name
Type: string

Name of the network analyzer configuration.

TraceContent
Type: TraceContent structure

Trace content for your wireless devices, gateways, and multicast groups.

WirelessDevices
Type: Array of strings

List of wireless device resources that have been added to the network analyzer configuration.

WirelessGateways
Type: Array of strings

List of wireless gateway resources that have been added to the network analyzer configuration.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetPartnerAccount

$result = $client->getPartnerAccount([/* ... */]);
$promise = $client->getPartnerAccountAsync([/* ... */]);

Gets information about a partner account. If PartnerAccountId and PartnerType are null, returns all partner accounts.

Parameter Syntax

$result = $client->getPartnerAccount([
    'PartnerAccountId' => '<string>', // REQUIRED
    'PartnerType' => 'Sidewalk', // REQUIRED
]);

Parameter Details

Members
PartnerAccountId
Required: Yes
Type: string

The partner account ID to disassociate from the AWS account.

PartnerType
Required: Yes
Type: string

The partner type.

Result Syntax

[
    'AccountLinked' => true || false,
    'Sidewalk' => [
        'AmazonId' => '<string>',
        'Arn' => '<string>',
        'Fingerprint' => '<string>',
    ],
]

Result Details

Members
AccountLinked
Type: boolean

Whether the partner account is linked to the AWS account.

Sidewalk

The Sidewalk account credentials.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetPosition

$result = $client->getPosition([/* ... */]);
$promise = $client->getPositionAsync([/* ... */]);

Get the position information for a given resource.

This action is no longer supported. Calls to retrieve the position information should use the GetResourcePosition API operation instead.

Parameter Syntax

$result = $client->getPosition([
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => 'WirelessDevice|WirelessGateway', // REQUIRED
]);

Parameter Details

Members
ResourceIdentifier
Required: Yes
Type: string

Resource identifier used to retrieve the position information.

ResourceType
Required: Yes
Type: string

Resource type of the resource for which position information is retrieved.

Result Syntax

[
    'Accuracy' => [
        'HorizontalAccuracy' => <float>,
        'VerticalAccuracy' => <float>,
    ],
    'Position' => [<float>, ...],
    'SolverProvider' => 'Semtech',
    'SolverType' => 'GNSS',
    'SolverVersion' => '<string>',
    'Timestamp' => '<string>',
]

Result Details

Members
Accuracy
Type: Accuracy structure

The accuracy of the estimated position in meters. An empty value indicates that no position data is available. A value of ‘0.0’ value indicates that position data is available. This data corresponds to the position information that you specified instead of the position computed by solver.

Position
Type: Array of floats

The position information of the resource.

SolverProvider
Type: string

The vendor of the positioning solver.

SolverType
Type: string

The type of solver used to identify the position of the resource.

SolverVersion
Type: string

The version of the positioning solver.

Timestamp
Type: string

The timestamp at which the device's position was determined.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

GetPositionConfiguration

$result = $client->getPositionConfiguration([/* ... */]);
$promise = $client->getPositionConfigurationAsync([/* ... */]);

Get position configuration for a given resource.

This action is no longer supported. Calls to retrieve the position configuration should use the GetResourcePosition API operation instead.

Parameter Syntax

$result = $client->getPositionConfiguration([
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => 'WirelessDevice|WirelessGateway', // REQUIRED
]);

Parameter Details

Members
ResourceIdentifier
Required: Yes
Type: string

Resource identifier used in a position configuration.

ResourceType
Required: Yes
Type: string

Resource type of the resource for which position configuration is retrieved.

Result Syntax

[
    'Destination' => '<string>',
    'Solvers' => [
        'SemtechGnss' => [
            'Fec' => 'ROSE|NONE',
            'Provider' => 'Semtech',
            'Status' => 'Enabled|Disabled',
            'Type' => 'GNSS',
        ],
    ],
]

Result Details

Members
Destination
Type: string

The position data destination that describes the AWS IoT rule that processes the device's position data for use by AWS IoT Core for LoRaWAN.

Solvers
Type: PositionSolverDetails structure

The wrapper for the solver configuration details object.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

GetPositionEstimate

$result = $client->getPositionEstimate([/* ... */]);
$promise = $client->getPositionEstimateAsync([/* ... */]);

Get estimated position information as a payload in GeoJSON format. The payload measurement data is resolved using solvers that are provided by third-party vendors.

Parameter Syntax

$result = $client->getPositionEstimate([
    'CellTowers' => [
        'Cdma' => [
            [
                'BaseLat' => <float>,
                'BaseLng' => <float>,
                'BaseStationId' => <integer>, // REQUIRED
                'CdmaLocalId' => [
                    'CdmaChannel' => <integer>, // REQUIRED
                    'PnOffset' => <integer>, // REQUIRED
                ],
                'CdmaNmr' => [
                    [
                        'BaseStationId' => <integer>,
                        'CdmaChannel' => <integer>, // REQUIRED
                        'PilotPower' => <integer>,
                        'PnOffset' => <integer>, // REQUIRED
                    ],
                    // ...
                ],
                'NetworkId' => <integer>, // REQUIRED
                'PilotPower' => <integer>,
                'RegistrationZone' => <integer>,
                'SystemId' => <integer>, // REQUIRED
            ],
            // ...
        ],
        'Gsm' => [
            [
                'GeranCid' => <integer>, // REQUIRED
                'GsmLocalId' => [
                    'Bcch' => <integer>, // REQUIRED
                    'Bsic' => <integer>, // REQUIRED
                ],
                'GsmNmr' => [
                    [
                        'Bcch' => <integer>, // REQUIRED
                        'Bsic' => <integer>, // REQUIRED
                        'GlobalIdentity' => [
                            'GeranCid' => <integer>, // REQUIRED
                            'Lac' => <integer>, // REQUIRED
                        ],
                        'RxLevel' => <integer>,
                    ],
                    // ...
                ],
                'GsmTimingAdvance' => <integer>,
                'Lac' => <integer>, // REQUIRED
                'Mcc' => <integer>, // REQUIRED
                'Mnc' => <integer>, // REQUIRED
                'RxLevel' => <integer>,
            ],
            // ...
        ],
        'Lte' => [
            [
                'EutranCid' => <integer>, // REQUIRED
                'LteLocalId' => [
                    'Earfcn' => <integer>, // REQUIRED
                    'Pci' => <integer>, // REQUIRED
                ],
                'LteNmr' => [
                    [
                        'Earfcn' => <integer>, // REQUIRED
                        'EutranCid' => <integer>, // REQUIRED
                        'Pci' => <integer>, // REQUIRED
                        'Rsrp' => <integer>,
                        'Rsrq' => <float>,
                    ],
                    // ...
                ],
                'LteTimingAdvance' => <integer>,
                'Mcc' => <integer>, // REQUIRED
                'Mnc' => <integer>, // REQUIRED
                'NrCapable' => true || false,
                'Rsrp' => <integer>,
                'Rsrq' => <float>,
                'Tac' => <integer>,
            ],
            // ...
        ],
        'Tdscdma' => [
            [
                'Lac' => <integer>,
                'Mcc' => <integer>, // REQUIRED
                'Mnc' => <integer>, // REQUIRED
                'PathLoss' => <integer>,
                'Rscp' => <integer>,
                'TdscdmaLocalId' => [
                    'CellParams' => <integer>, // REQUIRED
                    'Uarfcn' => <integer>, // REQUIRED
                ],
                'TdscdmaNmr' => [
                    [
                        'CellParams' => <integer>, // REQUIRED
                        'PathLoss' => <integer>,
                        'Rscp' => <integer>,
                        'Uarfcn' => <integer>, // REQUIRED
                        'UtranCid' => <integer>,
                    ],
                    // ...
                ],
                'TdscdmaTimingAdvance' => <integer>,
                'UtranCid' => <integer>, // REQUIRED
            ],
            // ...
        ],
        'Wcdma' => [
            [
                'Lac' => <integer>,
                'Mcc' => <integer>, // REQUIRED
                'Mnc' => <integer>, // REQUIRED
                'PathLoss' => <integer>,
                'Rscp' => <integer>,
                'UtranCid' => <integer>, // REQUIRED
                'WcdmaLocalId' => [
                    'Psc' => <integer>, // REQUIRED
                    'Uarfcndl' => <integer>, // REQUIRED
                ],
                'WcdmaNmr' => [
                    [
                        'PathLoss' => <integer>,
                        'Psc' => <integer>, // REQUIRED
                        'Rscp' => <integer>,
                        'Uarfcndl' => <integer>, // REQUIRED
                        'UtranCid' => <integer>, // REQUIRED
                    ],
                    // ...
                ],
            ],
            // ...
        ],
    ],
    'Gnss' => [
        'AssistAltitude' => <float>,
        'AssistPosition' => [<float>, ...],
        'CaptureTime' => <float>,
        'CaptureTimeAccuracy' => <float>,
        'Payload' => '<string>', // REQUIRED
        'Use2DSolver' => true || false,
    ],
    'Ip' => [
        'IpAddress' => '<string>', // REQUIRED
    ],
    'Timestamp' => <integer || string || DateTime>,
    'WiFiAccessPoints' => [
        [
            'MacAddress' => '<string>', // REQUIRED
            'Rss' => <integer>, // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
CellTowers
Type: CellTowers structure

Retrieves an estimated device position by resolving measurement data from cellular radio towers. The position is resolved using HERE's cellular-based solver.

Gnss
Type: Gnss structure

Retrieves an estimated device position by resolving the global navigation satellite system (GNSS) scan data. The position is resolved using the GNSS solver powered by LoRa Cloud.

Ip
Type: Ip structure

Retrieves an estimated device position by resolving the IP address information from the device. The position is resolved using MaxMind's IP-based solver.

Timestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

Optional information that specifies the time when the position information will be resolved. It uses the Unix timestamp format. If not specified, the time at which the request was received will be used.

WiFiAccessPoints
Type: Array of WiFiAccessPoint structures

Retrieves an estimated device position by resolving WLAN measurement data. The position is resolved using HERE's Wi-Fi based solver.

Result Syntax

[
    'GeoJsonPayload' => <string || resource || Psr\Http\Message\StreamInterface>,
]

Result Details

Members
GeoJsonPayload
Type: blob (string|resource|Psr\Http\Message\StreamInterface)

The position information of the resource, displayed as a JSON payload. The payload is of type blob and uses the GeoJSON format, which a format that's used to encode geographic data structures. A sample payload contains the timestamp information, the WGS84 coordinates of the location, and the accuracy and confidence level. For more information and examples, see Resolve device location (console).

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

GetResourceEventConfiguration

$result = $client->getResourceEventConfiguration([/* ... */]);
$promise = $client->getResourceEventConfigurationAsync([/* ... */]);

Get the event configuration for a particular resource identifier.

Parameter Syntax

$result = $client->getResourceEventConfiguration([
    'Identifier' => '<string>', // REQUIRED
    'IdentifierType' => 'PartnerAccountId|DevEui|FuotaTaskId|GatewayEui|WirelessDeviceId|WirelessGatewayId', // REQUIRED
    'PartnerType' => 'Sidewalk',
]);

Parameter Details

Members
Identifier
Required: Yes
Type: string

Resource identifier to opt in for event messaging.

IdentifierType
Required: Yes
Type: string

Identifier type of the particular resource identifier for event configuration.

PartnerType
Type: string

Partner type of the resource if the identifier type is PartnerAccountId.

Result Syntax

[
    'ConnectionStatus' => [
        'LoRaWAN' => [
            'GatewayEuiEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessGatewayIdEventTopic' => 'Enabled|Disabled',
    ],
    'DeviceRegistrationState' => [
        'Sidewalk' => [
            'AmazonIdEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
    ],
    'Join' => [
        'LoRaWAN' => [
            'DevEuiEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
    ],
    'MessageDeliveryStatus' => [
        'Sidewalk' => [
            'AmazonIdEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
    ],
    'Proximity' => [
        'Sidewalk' => [
            'AmazonIdEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
    ],
]

Result Details

Members
ConnectionStatus

Event configuration for the connection status event.

DeviceRegistrationState

Event configuration for the device registration state event.

Join
Type: JoinEventConfiguration structure

Event configuration for the join event.

MessageDeliveryStatus

Event configuration for the message delivery status event.

Proximity
Type: ProximityEventConfiguration structure

Event configuration for the proximity event.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

GetResourceLogLevel

$result = $client->getResourceLogLevel([/* ... */]);
$promise = $client->getResourceLogLevelAsync([/* ... */]);

Fetches the log-level override, if any, for a given resource-ID and resource-type. It can be used for a wireless device, wireless gateway or fuota task.

Parameter Syntax

$result = $client->getResourceLogLevel([
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => '<string>', // REQUIRED
]);

Parameter Details

Members
ResourceIdentifier
Required: Yes
Type: string

The identifier of the resource. For a Wireless Device, it is the wireless device ID. For a wireless gateway, it is the wireless gateway ID.

ResourceType
Required: Yes
Type: string

The type of the resource, which can be WirelessDevice, WirelessGateway or FuotaTask.

Result Syntax

[
    'LogLevel' => 'INFO|ERROR|DISABLED',
]

Result Details

Members
LogLevel
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

Errors

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ValidationException:

The input did not meet the specified constraints.

GetResourcePosition

$result = $client->getResourcePosition([/* ... */]);
$promise = $client->getResourcePositionAsync([/* ... */]);

Get the position information for a given wireless device or a wireless gateway resource. The position information uses the World Geodetic System (WGS84).

Parameter Syntax

$result = $client->getResourcePosition([
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => 'WirelessDevice|WirelessGateway', // REQUIRED
]);

Parameter Details

Members
ResourceIdentifier
Required: Yes
Type: string

The identifier of the resource for which position information is retrieved. It can be the wireless device ID or the wireless gateway ID, depending on the resource type.

ResourceType
Required: Yes
Type: string

The type of resource for which position information is retrieved, which can be a wireless device or a wireless gateway.

Result Syntax

[
    'GeoJsonPayload' => <string || resource || Psr\Http\Message\StreamInterface>,
]

Result Details

Members
GeoJsonPayload
Type: blob (string|resource|Psr\Http\Message\StreamInterface)

The position information of the resource, displayed as a JSON payload. The payload uses the GeoJSON format, which a format that's used to encode geographic data structures. For more information, see GeoJSON.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

GetServiceEndpoint

$result = $client->getServiceEndpoint([/* ... */]);
$promise = $client->getServiceEndpointAsync([/* ... */]);

Gets the account-specific endpoint for Configuration and Update Server (CUPS) protocol or LoRaWAN Network Server (LNS) connections.

Parameter Syntax

$result = $client->getServiceEndpoint([
    'ServiceType' => 'CUPS|LNS',
]);

Parameter Details

Members
ServiceType
Type: string

The service type for which to get endpoint information about. Can be CUPS for the Configuration and Update Server endpoint, or LNS for the LoRaWAN Network Server endpoint or CLAIM for the global endpoint.

Result Syntax

[
    'ServerTrust' => '<string>',
    'ServiceEndpoint' => '<string>',
    'ServiceType' => 'CUPS|LNS',
]

Result Details

Members
ServerTrust
Type: string

The Root CA of the server trust certificate.

ServiceEndpoint
Type: string

The service endpoint value.

ServiceType
Type: string

The endpoint's service type.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetServiceProfile

$result = $client->getServiceProfile([/* ... */]);
$promise = $client->getServiceProfileAsync([/* ... */]);

Gets information about a service profile.

Parameter Syntax

$result = $client->getServiceProfile([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to get.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
    'LoRaWAN' => [
        'AddGwMetadata' => true || false,
        'ChannelMask' => '<string>',
        'DevStatusReqFreq' => <integer>,
        'DlBucketSize' => <integer>,
        'DlRate' => <integer>,
        'DlRatePolicy' => '<string>',
        'DrMax' => <integer>,
        'DrMin' => <integer>,
        'HrAllowed' => true || false,
        'MinGwDiversity' => <integer>,
        'NwkGeoLoc' => true || false,
        'PrAllowed' => true || false,
        'RaAllowed' => true || false,
        'ReportDevStatusBattery' => true || false,
        'ReportDevStatusMargin' => true || false,
        'TargetPer' => <integer>,
        'UlBucketSize' => <integer>,
        'UlRate' => <integer>,
        'UlRatePolicy' => '<string>',
    ],
    'Name' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Id
Type: string

The ID of the service profile.

LoRaWAN

Information about the service profile.

Name
Type: string

The name of the resource.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessDevice

$result = $client->getWirelessDevice([/* ... */]);
$promise = $client->getWirelessDeviceAsync([/* ... */]);

Gets information about a wireless device.

Parameter Syntax

$result = $client->getWirelessDevice([
    'Identifier' => '<string>', // REQUIRED
    'IdentifierType' => 'WirelessDeviceId|DevEui|ThingName|SidewalkManufacturingSn', // REQUIRED
]);

Parameter Details

Members
Identifier
Required: Yes
Type: string

The identifier of the wireless device to get.

IdentifierType
Required: Yes
Type: string

The type of identifier used in identifier.

Result Syntax

[
    'Arn' => '<string>',
    'Description' => '<string>',
    'DestinationName' => '<string>',
    'Id' => '<string>',
    'LoRaWAN' => [
        'AbpV1_0_x' => [
            'DevAddr' => '<string>',
            'FCntStart' => <integer>,
            'SessionKeys' => [
                'AppSKey' => '<string>',
                'NwkSKey' => '<string>',
            ],
        ],
        'AbpV1_1' => [
            'DevAddr' => '<string>',
            'FCntStart' => <integer>,
            'SessionKeys' => [
                'AppSKey' => '<string>',
                'FNwkSIntKey' => '<string>',
                'NwkSEncKey' => '<string>',
                'SNwkSIntKey' => '<string>',
            ],
        ],
        'DevEui' => '<string>',
        'DeviceProfileId' => '<string>',
        'FPorts' => [
            'Applications' => [
                [
                    'DestinationName' => '<string>',
                    'FPort' => <integer>,
                    'Type' => 'SemtechGeolocation',
                ],
                // ...
            ],
            'ClockSync' => <integer>,
            'Fuota' => <integer>,
            'Multicast' => <integer>,
            'Positioning' => [
                'ClockSync' => <integer>,
                'Gnss' => <integer>,
                'Stream' => <integer>,
            ],
        ],
        'OtaaV1_0_x' => [
            'AppEui' => '<string>',
            'AppKey' => '<string>',
            'GenAppKey' => '<string>',
            'JoinEui' => '<string>',
        ],
        'OtaaV1_1' => [
            'AppKey' => '<string>',
            'JoinEui' => '<string>',
            'NwkKey' => '<string>',
        ],
        'ServiceProfileId' => '<string>',
    ],
    'Name' => '<string>',
    'Positioning' => 'Enabled|Disabled',
    'Sidewalk' => [
        'AmazonId' => '<string>',
        'CertificateId' => '<string>',
        'DeviceCertificates' => [
            [
                'SigningAlg' => 'Ed25519|P256r1',
                'Value' => '<string>',
            ],
            // ...
        ],
        'DeviceProfileId' => '<string>',
        'PrivateKeys' => [
            [
                'SigningAlg' => 'Ed25519|P256r1',
                'Value' => '<string>',
            ],
            // ...
        ],
        'SidewalkId' => '<string>',
        'SidewalkManufacturingSn' => '<string>',
        'Status' => 'PROVISIONED|REGISTERED|ACTIVATED|UNKNOWN',
    ],
    'ThingArn' => '<string>',
    'ThingName' => '<string>',
    'Type' => 'Sidewalk|LoRaWAN',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Description
Type: string

The description of the resource.

DestinationName
Type: string

The name of the destination to which the device is assigned.

Id
Type: string

The ID of the wireless device.

LoRaWAN
Type: LoRaWANDevice structure

Information about the wireless device.

Name
Type: string

The name of the resource.

Positioning
Type: string

FPort values for the GNSS, stream, and ClockSync functions of the positioning information.

Sidewalk
Type: SidewalkDevice structure

Sidewalk device object.

ThingArn
Type: string

The ARN of the thing associated with the wireless device.

ThingName
Type: string

The name of the thing associated with the wireless device. The value is empty if a thing isn't associated with the device.

Type
Type: string

The wireless device type.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessDeviceImportTask

$result = $client->getWirelessDeviceImportTask([/* ... */]);
$promise = $client->getWirelessDeviceImportTaskAsync([/* ... */]);

Get information about an import task and count of device onboarding summary information for the import task.

Parameter Syntax

$result = $client->getWirelessDeviceImportTask([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The identifier of the import task for which information is requested.

Result Syntax

[
    'Arn' => '<string>',
    'CreationTime' => <DateTime>,
    'DestinationName' => '<string>',
    'FailedImportedDeviceCount' => <integer>,
    'Id' => '<string>',
    'InitializedImportedDeviceCount' => <integer>,
    'OnboardedImportedDeviceCount' => <integer>,
    'PendingImportedDeviceCount' => <integer>,
    'Sidewalk' => [
        'DeviceCreationFileList' => ['<string>', ...],
        'Role' => '<string>',
    ],
    'Status' => 'INITIALIZING|INITIALIZED|PENDING|COMPLETE|FAILED|DELETING',
    'StatusReason' => '<string>',
]

Result Details

Members
Arn
Type: string

The ARN (Amazon Resource Name) of the import task.

CreationTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the import task was created.

DestinationName
Type: string

The name of the destination that's assigned to the wireless devices in the import task.

FailedImportedDeviceCount
Type: long (int|float)

The number of devices in the import task that failed to onboard to the import task.

Id
Type: string

The identifier of the import task for which information is retrieved.

InitializedImportedDeviceCount
Type: long (int|float)

The number of devices in the import task that are waiting for the control log to start processing.

OnboardedImportedDeviceCount
Type: long (int|float)

The number of devices in the import task that have been onboarded to the import task.

PendingImportedDeviceCount
Type: long (int|float)

The number of devices in the import task that are waiting in the import task queue to be onboarded.

Sidewalk
Type: SidewalkGetStartImportInfo structure

The Sidewalk-related information about an import task.

Status
Type: string

The import task status.

StatusReason
Type: string

The reason for the provided status information, such as a validation error that causes the import task to fail.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessDeviceStatistics

$result = $client->getWirelessDeviceStatistics([/* ... */]);
$promise = $client->getWirelessDeviceStatisticsAsync([/* ... */]);

Gets operating information about a wireless device.

Parameter Syntax

$result = $client->getWirelessDeviceStatistics([
    'WirelessDeviceId' => '<string>', // REQUIRED
]);

Parameter Details

Members
WirelessDeviceId
Required: Yes
Type: string

The ID of the wireless device for which to get the data.

Result Syntax

[
    'LastUplinkReceivedAt' => '<string>',
    'LoRaWAN' => [
        'DataRate' => <integer>,
        'DevEui' => '<string>',
        'FPort' => <integer>,
        'Frequency' => <integer>,
        'Gateways' => [
            [
                'GatewayEui' => '<string>',
                'Rssi' => <float>,
                'Snr' => <float>,
            ],
            // ...
        ],
        'PublicGateways' => [
            [
                'DlAllowed' => true || false,
                'Id' => '<string>',
                'ProviderNetId' => '<string>',
                'RfRegion' => '<string>',
                'Rssi' => <float>,
                'Snr' => <float>,
            ],
            // ...
        ],
        'Timestamp' => '<string>',
    ],
    'Sidewalk' => [
        'BatteryLevel' => 'normal|low|critical',
        'DeviceState' => 'Provisioned|RegisteredNotSeen|RegisteredReachable|RegisteredUnreachable',
        'Event' => 'discovered|lost|ack|nack|passthrough',
        'Rssi' => <integer>,
    ],
    'WirelessDeviceId' => '<string>',
]

Result Details

Members
LastUplinkReceivedAt
Type: string

The date and time when the most recent uplink was received.

This value is only valid for 3 months.

LoRaWAN
Type: LoRaWANDeviceMetadata structure

Information about the wireless device's operations.

Sidewalk
Type: SidewalkDeviceMetadata structure

MetaData for Sidewalk device.

WirelessDeviceId
Type: string

The ID of the wireless device.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessGateway

$result = $client->getWirelessGateway([/* ... */]);
$promise = $client->getWirelessGatewayAsync([/* ... */]);

Gets information about a wireless gateway.

Parameter Syntax

$result = $client->getWirelessGateway([
    'Identifier' => '<string>', // REQUIRED
    'IdentifierType' => 'GatewayEui|WirelessGatewayId|ThingName', // REQUIRED
]);

Parameter Details

Members
Identifier
Required: Yes
Type: string

The identifier of the wireless gateway to get.

IdentifierType
Required: Yes
Type: string

The type of identifier used in identifier.

Result Syntax

[
    'Arn' => '<string>',
    'Description' => '<string>',
    'Id' => '<string>',
    'LoRaWAN' => [
        'Beaconing' => [
            'DataRate' => <integer>,
            'Frequencies' => [<integer>, ...],
        ],
        'GatewayEui' => '<string>',
        'JoinEuiFilters' => [
            ['<string>', ...],
            // ...
        ],
        'MaxEirp' => <float>,
        'NetIdFilters' => ['<string>', ...],
        'RfRegion' => '<string>',
        'SubBands' => [<integer>, ...],
    ],
    'Name' => '<string>',
    'ThingArn' => '<string>',
    'ThingName' => '<string>',
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Description
Type: string

The description of the resource.

Id
Type: string

The ID of the wireless gateway.

LoRaWAN
Type: LoRaWANGateway structure

Information about the wireless gateway.

Name
Type: string

The name of the resource.

ThingArn
Type: string

The ARN of the thing associated with the wireless gateway.

ThingName
Type: string

The name of the thing associated with the wireless gateway. The value is empty if a thing isn't associated with the gateway.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessGatewayCertificate

$result = $client->getWirelessGatewayCertificate([/* ... */]);
$promise = $client->getWirelessGatewayCertificateAsync([/* ... */]);

Gets the ID of the certificate that is currently associated with a wireless gateway.

Parameter Syntax

$result = $client->getWirelessGatewayCertificate([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to get.

Result Syntax

[
    'IotCertificateId' => '<string>',
    'LoRaWANNetworkServerCertificateId' => '<string>',
]

Result Details

Members
IotCertificateId
Type: string

The ID of the certificate associated with the wireless gateway.

LoRaWANNetworkServerCertificateId
Type: string

The ID of the certificate that is associated with the wireless gateway and used for the LoRaWANNetworkServer endpoint.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessGatewayFirmwareInformation

$result = $client->getWirelessGatewayFirmwareInformation([/* ... */]);
$promise = $client->getWirelessGatewayFirmwareInformationAsync([/* ... */]);

Gets the firmware version and other information about a wireless gateway.

Parameter Syntax

$result = $client->getWirelessGatewayFirmwareInformation([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to get.

Result Syntax

[
    'LoRaWAN' => [
        'CurrentVersion' => [
            'Model' => '<string>',
            'PackageVersion' => '<string>',
            'Station' => '<string>',
        ],
    ],
]

Result Details

Members
LoRaWAN

Information about the wireless gateway's firmware.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessGatewayStatistics

$result = $client->getWirelessGatewayStatistics([/* ... */]);
$promise = $client->getWirelessGatewayStatisticsAsync([/* ... */]);

Gets operating information about a wireless gateway.

Parameter Syntax

$result = $client->getWirelessGatewayStatistics([
    'WirelessGatewayId' => '<string>', // REQUIRED
]);

Parameter Details

Members
WirelessGatewayId
Required: Yes
Type: string

The ID of the wireless gateway for which to get the data.

Result Syntax

[
    'ConnectionStatus' => 'Connected|Disconnected',
    'LastUplinkReceivedAt' => '<string>',
    'WirelessGatewayId' => '<string>',
]

Result Details

Members
ConnectionStatus
Type: string

The connection status of the wireless gateway.

LastUplinkReceivedAt
Type: string

The date and time when the most recent uplink was received.

This value is only valid for 3 months.

WirelessGatewayId
Type: string

The ID of the wireless gateway.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessGatewayTask

$result = $client->getWirelessGatewayTask([/* ... */]);
$promise = $client->getWirelessGatewayTaskAsync([/* ... */]);

Gets information about a wireless gateway task.

Parameter Syntax

$result = $client->getWirelessGatewayTask([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to get.

Result Syntax

[
    'LastUplinkReceivedAt' => '<string>',
    'Status' => 'PENDING|IN_PROGRESS|FIRST_RETRY|SECOND_RETRY|COMPLETED|FAILED',
    'TaskCreatedAt' => '<string>',
    'WirelessGatewayId' => '<string>',
    'WirelessGatewayTaskDefinitionId' => '<string>',
]

Result Details

Members
LastUplinkReceivedAt
Type: string

The date and time when the most recent uplink was received.

This value is only valid for 3 months.

Status
Type: string

The status of the request.

TaskCreatedAt
Type: string

The date and time when the task was created.

WirelessGatewayId
Type: string

The ID of the wireless gateway.

WirelessGatewayTaskDefinitionId
Type: string

The ID of the WirelessGatewayTask.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

GetWirelessGatewayTaskDefinition

$result = $client->getWirelessGatewayTaskDefinition([/* ... */]);
$promise = $client->getWirelessGatewayTaskDefinitionAsync([/* ... */]);

Gets information about a wireless gateway task definition.

Parameter Syntax

$result = $client->getWirelessGatewayTaskDefinition([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the resource to get.

Result Syntax

[
    'Arn' => '<string>',
    'AutoCreateTasks' => true || false,
    'Name' => '<string>',
    'Update' => [
        'LoRaWAN' => [
            'CurrentVersion' => [
                'Model' => '<string>',
                'PackageVersion' => '<string>',
                'Station' => '<string>',
            ],
            'SigKeyCrc' => <integer>,
            'UpdateSignature' => '<string>',
            'UpdateVersion' => [
                'Model' => '<string>',
                'PackageVersion' => '<string>',
                'Station' => '<string>',
            ],
        ],
        'UpdateDataRole' => '<string>',
        'UpdateDataSource' => '<string>',
    ],
]

Result Details

Members
Arn
Type: string

The Amazon Resource Name of the resource.

AutoCreateTasks
Type: boolean

Whether to automatically create tasks using this task definition for all gateways with the specified current version. If false, the task must me created by calling CreateWirelessGatewayTask.

Name
Type: string

The name of the resource.

Update

Information about the gateways to update.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListDestinations

$result = $client->listDestinations([/* ... */]);
$promise = $client->listDestinationsAsync([/* ... */]);

Lists the destinations registered to your AWS account.

Parameter Syntax

$result = $client->listDestinations([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'DestinationList' => [
        [
            'Arn' => '<string>',
            'Description' => '<string>',
            'Expression' => '<string>',
            'ExpressionType' => 'RuleName|MqttTopic',
            'Name' => '<string>',
            'RoleArn' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
DestinationList
Type: Array of Destinations structures

The list of destinations.

NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListDeviceProfiles

$result = $client->listDeviceProfiles([/* ... */]);
$promise = $client->listDeviceProfilesAsync([/* ... */]);

Lists the device profiles registered to your AWS account.

Parameter Syntax

$result = $client->listDeviceProfiles([
    'DeviceProfileType' => 'Sidewalk|LoRaWAN',
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
DeviceProfileType
Type: string

A filter to list only device profiles that use this type, which can be LoRaWAN or Sidewalk.

MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'DeviceProfileList' => [
        [
            'Arn' => '<string>',
            'Id' => '<string>',
            'Name' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
DeviceProfileList
Type: Array of DeviceProfile structures

The list of device profiles.

NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListDevicesForWirelessDeviceImportTask

$result = $client->listDevicesForWirelessDeviceImportTask([/* ... */]);
$promise = $client->listDevicesForWirelessDeviceImportTaskAsync([/* ... */]);

List the Sidewalk devices in an import task and their onboarding status.

Parameter Syntax

$result = $client->listDevicesForWirelessDeviceImportTask([
    'Id' => '<string>', // REQUIRED
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'Status' => 'INITIALIZED|PENDING|ONBOARDED|FAILED',
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The identifier of the import task for which wireless devices are listed.

MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Status
Type: string

The status of the devices in the import task.

Result Syntax

[
    'DestinationName' => '<string>',
    'ImportedWirelessDeviceList' => [
        [
            'Sidewalk' => [
                'LastUpdateTime' => <DateTime>,
                'OnboardingStatus' => 'INITIALIZED|PENDING|ONBOARDED|FAILED',
                'OnboardingStatusReason' => '<string>',
                'SidewalkManufacturingSn' => '<string>',
            ],
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
DestinationName
Type: string

The name of the Sidewalk destination that describes the IoT rule to route messages received from devices in an import task that are onboarded to AWS IoT Wireless.

ImportedWirelessDeviceList
Type: Array of ImportedWirelessDevice structures

List of wireless devices in an import task and their onboarding status.

NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListEventConfigurations

$result = $client->listEventConfigurations([/* ... */]);
$promise = $client->listEventConfigurationsAsync([/* ... */]);

List event configurations where at least one event topic has been enabled.

Parameter Syntax

$result = $client->listEventConfigurations([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'ResourceType' => 'FuotaTask|SidewalkAccount|WirelessDevice|WirelessGateway', // REQUIRED
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

ResourceType
Required: Yes
Type: string

Resource type to filter event configurations.

Result Syntax

[
    'EventConfigurationsList' => [
        [
            'Events' => [
                'ConnectionStatus' => [
                    'LoRaWAN' => [
                        'GatewayEuiEventTopic' => 'Enabled|Disabled',
                    ],
                    'WirelessGatewayIdEventTopic' => 'Enabled|Disabled',
                ],
                'DeviceRegistrationState' => [
                    'Sidewalk' => [
                        'AmazonIdEventTopic' => 'Enabled|Disabled',
                    ],
                    'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
                ],
                'Join' => [
                    'LoRaWAN' => [
                        'DevEuiEventTopic' => 'Enabled|Disabled',
                    ],
                    'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
                ],
                'MessageDeliveryStatus' => [
                    'Sidewalk' => [
                        'AmazonIdEventTopic' => 'Enabled|Disabled',
                    ],
                    'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
                ],
                'Proximity' => [
                    'Sidewalk' => [
                        'AmazonIdEventTopic' => 'Enabled|Disabled',
                    ],
                    'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
                ],
            ],
            'Identifier' => '<string>',
            'IdentifierType' => 'PartnerAccountId|DevEui|FuotaTaskId|GatewayEui|WirelessDeviceId|WirelessGatewayId',
            'PartnerType' => 'Sidewalk',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
EventConfigurationsList
Type: Array of EventConfigurationItem structures

Event configurations of all events for a single resource.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

ListFuotaTasks

$result = $client->listFuotaTasks([/* ... */]);
$promise = $client->listFuotaTasksAsync([/* ... */]);

Lists the FUOTA tasks registered to your AWS account.

Parameter Syntax

$result = $client->listFuotaTasks([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'FuotaTaskList' => [
        [
            'Arn' => '<string>',
            'Id' => '<string>',
            'Name' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
FuotaTaskList
Type: Array of FuotaTask structures

Lists the FUOTA tasks registered to your AWS account.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListMulticastGroups

$result = $client->listMulticastGroups([/* ... */]);
$promise = $client->listMulticastGroupsAsync([/* ... */]);

Lists the multicast groups registered to your AWS account.

Parameter Syntax

$result = $client->listMulticastGroups([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'MulticastGroupList' => [
        [
            'Arn' => '<string>',
            'Id' => '<string>',
            'Name' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
MulticastGroupList
Type: Array of MulticastGroup structures

List of multicast groups.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListMulticastGroupsByFuotaTask

$result = $client->listMulticastGroupsByFuotaTask([/* ... */]);
$promise = $client->listMulticastGroupsByFuotaTaskAsync([/* ... */]);

List all multicast groups associated with a fuota task.

Parameter Syntax

$result = $client->listMulticastGroupsByFuotaTask([
    'Id' => '<string>', // REQUIRED
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a FUOTA task.

MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'MulticastGroupList' => [
        [
            'Id' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
MulticastGroupList
Type: Array of MulticastGroupByFuotaTask structures

List of multicast groups associated with a FUOTA task.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListNetworkAnalyzerConfigurations

$result = $client->listNetworkAnalyzerConfigurations([/* ... */]);
$promise = $client->listNetworkAnalyzerConfigurationsAsync([/* ... */]);

Lists the network analyzer configurations.

Parameter Syntax

$result = $client->listNetworkAnalyzerConfigurations([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'NetworkAnalyzerConfigurationList' => [
        [
            'Arn' => '<string>',
            'Name' => '<string>',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
NetworkAnalyzerConfigurationList
Type: Array of NetworkAnalyzerConfigurations structures

The list of network analyzer configurations.

NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListPartnerAccounts

$result = $client->listPartnerAccounts([/* ... */]);
$promise = $client->listPartnerAccountsAsync([/* ... */]);

Lists the partner accounts associated with your AWS account.

Parameter Syntax

$result = $client->listPartnerAccounts([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'NextToken' => '<string>',
    'Sidewalk' => [
        [
            'AmazonId' => '<string>',
            'Arn' => '<string>',
            'Fingerprint' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

Sidewalk
Type: Array of SidewalkAccountInfoWithFingerprint structures

The Sidewalk account credentials.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListPositionConfigurations

$result = $client->listPositionConfigurations([/* ... */]);
$promise = $client->listPositionConfigurationsAsync([/* ... */]);

List position configurations for a given resource, such as positioning solvers.

This action is no longer supported. Calls to retrieve position information should use the GetResourcePosition API operation instead.

Parameter Syntax

$result = $client->listPositionConfigurations([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'ResourceType' => 'WirelessDevice|WirelessGateway',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

ResourceType
Type: string

Resource type for which position configurations are listed.

Result Syntax

[
    'NextToken' => '<string>',
    'PositionConfigurationList' => [
        [
            'Destination' => '<string>',
            'ResourceIdentifier' => '<string>',
            'ResourceType' => 'WirelessDevice|WirelessGateway',
            'Solvers' => [
                'SemtechGnss' => [
                    'Fec' => 'ROSE|NONE',
                    'Provider' => 'Semtech',
                    'Status' => 'Enabled|Disabled',
                    'Type' => 'GNSS',
                ],
            ],
        ],
        // ...
    ],
]

Result Details

Members
NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

PositionConfigurationList
Type: Array of PositionConfigurationItem structures

A list of position configurations.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

ListQueuedMessages

$result = $client->listQueuedMessages([/* ... */]);
$promise = $client->listQueuedMessagesAsync([/* ... */]);

List queued messages in the downlink queue.

Parameter Syntax

$result = $client->listQueuedMessages([
    'Id' => '<string>', // REQUIRED
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'WirelessDeviceType' => 'Sidewalk|LoRaWAN',
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a given wireless device which the downlink message packets are being sent.

MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

WirelessDeviceType
Type: string

The wireless device type, whic can be either Sidewalk or LoRaWAN.

Result Syntax

[
    'DownlinkQueueMessagesList' => [
        [
            'LoRaWAN' => [
                'FPort' => <integer>,
                'ParticipatingGateways' => [
                    'DownlinkMode' => 'SEQUENTIAL|CONCURRENT|USING_UPLINK_GATEWAY',
                    'GatewayList' => [
                        [
                            'DownlinkFrequency' => <integer>,
                            'GatewayId' => '<string>',
                        ],
                        // ...
                    ],
                    'TransmissionInterval' => <integer>,
                ],
            ],
            'MessageId' => '<string>',
            'ReceivedAt' => '<string>',
            'TransmitMode' => <integer>,
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Members
DownlinkQueueMessagesList
Type: Array of DownlinkQueueMessage structures

The messages in the downlink queue.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

AccessDeniedException:

User does not have permission to perform this action.

ListServiceProfiles

$result = $client->listServiceProfiles([/* ... */]);
$promise = $client->listServiceProfilesAsync([/* ... */]);

Lists the service profiles registered to your AWS account.

Parameter Syntax

$result = $client->listServiceProfiles([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'NextToken' => '<string>',
    'ServiceProfileList' => [
        [
            'Arn' => '<string>',
            'Id' => '<string>',
            'Name' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

ServiceProfileList
Type: Array of ServiceProfile structures

The list of service profiles.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListTagsForResource

$result = $client->listTagsForResource([/* ... */]);
$promise = $client->listTagsForResourceAsync([/* ... */]);

Lists the tags (metadata) you have assigned to the resource.

Parameter Syntax

$result = $client->listTagsForResource([
    'ResourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
ResourceArn
Required: Yes
Type: string

The ARN of the resource for which you want to list tags.

Result Syntax

[
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
Tags
Type: Array of Tag structures

The tags to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListWirelessDeviceImportTasks

$result = $client->listWirelessDeviceImportTasks([/* ... */]);
$promise = $client->listWirelessDeviceImportTasksAsync([/* ... */]);

List wireless devices that have been added to an import task.

Parameter Syntax

$result = $client->listWirelessDeviceImportTasks([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'NextToken' => '<string>',
    'WirelessDeviceImportTaskList' => [
        [
            'Arn' => '<string>',
            'CreationTime' => <DateTime>,
            'DestinationName' => '<string>',
            'FailedImportedDeviceCount' => <integer>,
            'Id' => '<string>',
            'InitializedImportedDeviceCount' => <integer>,
            'OnboardedImportedDeviceCount' => <integer>,
            'PendingImportedDeviceCount' => <integer>,
            'Sidewalk' => [
                'DeviceCreationFileList' => ['<string>', ...],
                'Role' => '<string>',
            ],
            'Status' => 'INITIALIZING|INITIALIZED|PENDING|COMPLETE|FAILED|DELETING',
            'StatusReason' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

WirelessDeviceImportTaskList
Type: Array of WirelessDeviceImportTask structures

List of import tasks and summary information of onboarding status of devices in each import task.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListWirelessDevices

$result = $client->listWirelessDevices([/* ... */]);
$promise = $client->listWirelessDevicesAsync([/* ... */]);

Lists the wireless devices registered to your AWS account.

Parameter Syntax

$result = $client->listWirelessDevices([
    'DestinationName' => '<string>',
    'DeviceProfileId' => '<string>',
    'FuotaTaskId' => '<string>',
    'MaxResults' => <integer>,
    'MulticastGroupId' => '<string>',
    'NextToken' => '<string>',
    'ServiceProfileId' => '<string>',
    'WirelessDeviceType' => 'Sidewalk|LoRaWAN',
]);

Parameter Details

Members
DestinationName
Type: string

A filter to list only the wireless devices that use this destination.

DeviceProfileId
Type: string

A filter to list only the wireless devices that use this device profile.

FuotaTaskId
Type: string

The ID of a FUOTA task.

MaxResults
Type: int

The maximum number of results to return in this operation.

MulticastGroupId
Type: string

The ID of the multicast group.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

ServiceProfileId
Type: string

A filter to list only the wireless devices that use this service profile.

WirelessDeviceType
Type: string

A filter to list only the wireless devices that use this wireless device type.

Result Syntax

[
    'NextToken' => '<string>',
    'WirelessDeviceList' => [
        [
            'Arn' => '<string>',
            'DestinationName' => '<string>',
            'FuotaDeviceStatus' => 'Initial|Package_Not_Supported|FragAlgo_unsupported|Not_enough_memory|FragIndex_unsupported|Wrong_descriptor|SessionCnt_replay|MissingFrag|MemoryError|MICError|Successful|Device_exist_in_conflict_fuota_task',
            'Id' => '<string>',
            'LastUplinkReceivedAt' => '<string>',
            'LoRaWAN' => [
                'DevEui' => '<string>',
            ],
            'McGroupId' => <integer>,
            'MulticastDeviceStatus' => '<string>',
            'Name' => '<string>',
            'Sidewalk' => [
                'AmazonId' => '<string>',
                'DeviceCertificates' => [
                    [
                        'SigningAlg' => 'Ed25519|P256r1',
                        'Value' => '<string>',
                    ],
                    // ...
                ],
                'DeviceProfileId' => '<string>',
                'SidewalkId' => '<string>',
                'SidewalkManufacturingSn' => '<string>',
                'Status' => 'PROVISIONED|REGISTERED|ACTIVATED|UNKNOWN',
            ],
            'Type' => 'Sidewalk|LoRaWAN',
        ],
        // ...
    ],
]

Result Details

Members
NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

WirelessDeviceList
Type: Array of WirelessDeviceStatistics structures

The ID of the wireless device.

Errors

ValidationException:

The input did not meet the specified constraints.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

AccessDeniedException:

User does not have permission to perform this action.

ListWirelessGatewayTaskDefinitions

$result = $client->listWirelessGatewayTaskDefinitions([/* ... */]);
$promise = $client->listWirelessGatewayTaskDefinitionsAsync([/* ... */]);

List the wireless gateway tasks definitions registered to your AWS account.

Parameter Syntax

$result = $client->listWirelessGatewayTaskDefinitions([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
    'TaskDefinitionType' => 'UPDATE',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

TaskDefinitionType
Type: string

A filter to list only the wireless gateway task definitions that use this task definition type.

Result Syntax

[
    'NextToken' => '<string>',
    'TaskDefinitions' => [
        [
            'Arn' => '<string>',
            'Id' => '<string>',
            'LoRaWAN' => [
                'CurrentVersion' => [
                    'Model' => '<string>',
                    'PackageVersion' => '<string>',
                    'Station' => '<string>',
                ],
                'UpdateVersion' => [
                    'Model' => '<string>',
                    'PackageVersion' => '<string>',
                    'Station' => '<string>',
                ],
            ],
        ],
        // ...
    ],
]

Result Details

Members
NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

TaskDefinitions
Type: Array of UpdateWirelessGatewayTaskEntry structures

The list of task definitions.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ListWirelessGateways

$result = $client->listWirelessGateways([/* ... */]);
$promise = $client->listWirelessGatewaysAsync([/* ... */]);

Lists the wireless gateways registered to your AWS account.

Parameter Syntax

$result = $client->listWirelessGateways([
    'MaxResults' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Members
MaxResults
Type: int

The maximum number of results to return in this operation.

NextToken
Type: string

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

Result Syntax

[
    'NextToken' => '<string>',
    'WirelessGatewayList' => [
        [
            'Arn' => '<string>',
            'Description' => '<string>',
            'Id' => '<string>',
            'LastUplinkReceivedAt' => '<string>',
            'LoRaWAN' => [
                'Beaconing' => [
                    'DataRate' => <integer>,
                    'Frequencies' => [<integer>, ...],
                ],
                'GatewayEui' => '<string>',
                'JoinEuiFilters' => [
                    ['<string>', ...],
                    // ...
                ],
                'MaxEirp' => <float>,
                'NetIdFilters' => ['<string>', ...],
                'RfRegion' => '<string>',
                'SubBands' => [<integer>, ...],
            ],
            'Name' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
NextToken
Type: string

The token to use to get the next set of results, or null if there are no additional results.

WirelessGatewayList
Type: Array of WirelessGatewayStatistics structures

The ID of the wireless gateway.

Errors

ValidationException:

The input did not meet the specified constraints.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

AccessDeniedException:

User does not have permission to perform this action.

PutPositionConfiguration

$result = $client->putPositionConfiguration([/* ... */]);
$promise = $client->putPositionConfigurationAsync([/* ... */]);

Put position configuration for a given resource.

This action is no longer supported. Calls to update the position configuration should use the UpdateResourcePosition API operation instead.

Parameter Syntax

$result = $client->putPositionConfiguration([
    'Destination' => '<string>',
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => 'WirelessDevice|WirelessGateway', // REQUIRED
    'Solvers' => [
        'SemtechGnss' => [
            'Fec' => 'ROSE|NONE', // REQUIRED
            'Status' => 'Enabled|Disabled', // REQUIRED
        ],
    ],
]);

Parameter Details

Members
Destination
Type: string

The position data destination that describes the AWS IoT rule that processes the device's position data for use by AWS IoT Core for LoRaWAN.

ResourceIdentifier
Required: Yes
Type: string

Resource identifier used to update the position configuration.

ResourceType
Required: Yes
Type: string

Resource type of the resource for which you want to update the position configuration.

Solvers

The positioning solvers used to update the position configuration of the resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

PutResourceLogLevel

$result = $client->putResourceLogLevel([/* ... */]);
$promise = $client->putResourceLogLevelAsync([/* ... */]);

Sets the log-level override for a resource-ID and resource-type. This option can be specified for a wireless gateway or a wireless device. A limit of 200 log level override can be set per account.

Parameter Syntax

$result = $client->putResourceLogLevel([
    'LogLevel' => 'INFO|ERROR|DISABLED', // REQUIRED
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => '<string>', // REQUIRED
]);

Parameter Details

Members
LogLevel
Required: Yes
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

ResourceIdentifier
Required: Yes
Type: string

The identifier of the resource. For a Wireless Device, it is the wireless device ID. For a wireless gateway, it is the wireless gateway ID.

ResourceType
Required: Yes
Type: string

The type of the resource, which can be WirelessDevice, WirelessGateway, or FuotaTask.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ValidationException:

The input did not meet the specified constraints.

ResetAllResourceLogLevels

$result = $client->resetAllResourceLogLevels([/* ... */]);
$promise = $client->resetAllResourceLogLevelsAsync([/* ... */]);

Removes the log-level overrides for all resources; wireless devices, wireless gateways, and fuota tasks.

Parameter Syntax

$result = $client->resetAllResourceLogLevels([
]);

Parameter Details

Members

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ValidationException:

The input did not meet the specified constraints.

ResetResourceLogLevel

$result = $client->resetResourceLogLevel([/* ... */]);
$promise = $client->resetResourceLogLevelAsync([/* ... */]);

Removes the log-level override, if any, for a specific resource-ID and resource-type. It can be used for a wireless device, a wireless gateway, or a fuota task.

Parameter Syntax

$result = $client->resetResourceLogLevel([
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => '<string>', // REQUIRED
]);

Parameter Details

Members
ResourceIdentifier
Required: Yes
Type: string

The identifier of the resource. For a Wireless Device, it is the wireless device ID. For a wireless gateway, it is the wireless gateway ID.

ResourceType
Required: Yes
Type: string

The type of the resource, which can be WirelessDevice, WirelessGateway, or FuotaTask.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ValidationException:

The input did not meet the specified constraints.

SendDataToMulticastGroup

$result = $client->sendDataToMulticastGroup([/* ... */]);
$promise = $client->sendDataToMulticastGroupAsync([/* ... */]);

Sends the specified data to a multicast group.

Parameter Syntax

$result = $client->sendDataToMulticastGroup([
    'Id' => '<string>', // REQUIRED
    'PayloadData' => '<string>', // REQUIRED
    'WirelessMetadata' => [ // REQUIRED
        'LoRaWAN' => [
            'FPort' => <integer>,
        ],
    ],
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

PayloadData
Required: Yes
Type: string

The binary to be sent to the end device, encoded in base64.

WirelessMetadata
Required: Yes
Type: MulticastWirelessMetadata structure

Wireless metadata that is to be sent to multicast group.

Result Syntax

[
    'MessageId' => '<string>',
]

Result Details

Members
MessageId
Type: string

ID of a multicast group message.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

SendDataToWirelessDevice

$result = $client->sendDataToWirelessDevice([/* ... */]);
$promise = $client->sendDataToWirelessDeviceAsync([/* ... */]);

Sends a decrypted application data frame to a device.

Parameter Syntax

$result = $client->sendDataToWirelessDevice([
    'Id' => '<string>', // REQUIRED
    'PayloadData' => '<string>', // REQUIRED
    'TransmitMode' => <integer>, // REQUIRED
    'WirelessMetadata' => [
        'LoRaWAN' => [
            'FPort' => <integer>,
            'ParticipatingGateways' => [
                'DownlinkMode' => 'SEQUENTIAL|CONCURRENT|USING_UPLINK_GATEWAY', // REQUIRED
                'GatewayList' => [ // REQUIRED
                    [
                        'DownlinkFrequency' => <integer>, // REQUIRED
                        'GatewayId' => '<string>', // REQUIRED
                    ],
                    // ...
                ],
                'TransmissionInterval' => <integer>, // REQUIRED
            ],
        ],
        'Sidewalk' => [
            'AckModeRetryDurationSecs' => <integer>,
            'MessageType' => 'CUSTOM_COMMAND_ID_NOTIFY|CUSTOM_COMMAND_ID_GET|CUSTOM_COMMAND_ID_SET|CUSTOM_COMMAND_ID_RESP',
            'Seq' => <integer>,
        ],
    ],
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the wireless device to receive the data.

PayloadData
Required: Yes
Type: string

The binary to be sent to the end device, encoded in base64.

TransmitMode
Required: Yes
Type: int

The transmit mode to use to send data to the wireless device. Can be: 0 for UM (unacknowledge mode) or 1 for AM (acknowledge mode).

WirelessMetadata
Type: WirelessMetadata structure

Metadata about the message request.

Result Syntax

[
    'MessageId' => '<string>',
]

Result Details

Members
MessageId
Type: string

The ID of the message sent to the wireless device.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

StartBulkAssociateWirelessDeviceWithMulticastGroup

$result = $client->startBulkAssociateWirelessDeviceWithMulticastGroup([/* ... */]);
$promise = $client->startBulkAssociateWirelessDeviceWithMulticastGroupAsync([/* ... */]);

Starts a bulk association of all qualifying wireless devices with a multicast group.

Parameter Syntax

$result = $client->startBulkAssociateWirelessDeviceWithMulticastGroup([
    'Id' => '<string>', // REQUIRED
    'QueryString' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

QueryString
Type: string

Query string used to search for wireless devices as part of the bulk associate and disassociate process.

Tags
Type: Array of Tag structures

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

StartBulkDisassociateWirelessDeviceFromMulticastGroup

$result = $client->startBulkDisassociateWirelessDeviceFromMulticastGroup([/* ... */]);
$promise = $client->startBulkDisassociateWirelessDeviceFromMulticastGroupAsync([/* ... */]);

Starts a bulk disassociatin of all qualifying wireless devices from a multicast group.

Parameter Syntax

$result = $client->startBulkDisassociateWirelessDeviceFromMulticastGroup([
    'Id' => '<string>', // REQUIRED
    'QueryString' => '<string>',
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

QueryString
Type: string

Query string used to search for wireless devices as part of the bulk associate and disassociate process.

Tags
Type: Array of Tag structures

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

StartFuotaTask

$result = $client->startFuotaTask([/* ... */]);
$promise = $client->startFuotaTaskAsync([/* ... */]);

Starts a FUOTA task.

Parameter Syntax

$result = $client->startFuotaTask([
    'Id' => '<string>', // REQUIRED
    'LoRaWAN' => [
        'StartTime' => <integer || string || DateTime>,
    ],
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of a FUOTA task.

LoRaWAN
Type: LoRaWANStartFuotaTask structure

The LoRaWAN information used to start a FUOTA task.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

StartMulticastGroupSession

$result = $client->startMulticastGroupSession([/* ... */]);
$promise = $client->startMulticastGroupSessionAsync([/* ... */]);

Starts a multicast group session.

Parameter Syntax

$result = $client->startMulticastGroupSession([
    'Id' => '<string>', // REQUIRED
    'LoRaWAN' => [ // REQUIRED
        'DlDr' => <integer>,
        'DlFreq' => <integer>,
        'PingSlotPeriod' => <integer>,
        'SessionStartTime' => <integer || string || DateTime>,
        'SessionTimeout' => <integer>,
    ],
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the multicast group.

LoRaWAN
Required: Yes
Type: LoRaWANMulticastSession structure

The LoRaWAN information used with the multicast session.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

StartSingleWirelessDeviceImportTask

$result = $client->startSingleWirelessDeviceImportTask([/* ... */]);
$promise = $client->startSingleWirelessDeviceImportTaskAsync([/* ... */]);

Start import task for a single wireless device.

Parameter Syntax

$result = $client->startSingleWirelessDeviceImportTask([
    'ClientRequestToken' => '<string>',
    'DestinationName' => '<string>', // REQUIRED
    'DeviceName' => '<string>',
    'Sidewalk' => [ // REQUIRED
        'SidewalkManufacturingSn' => '<string>',
    ],
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

DestinationName
Required: Yes
Type: string

The name of the Sidewalk destination that describes the IoT rule to route messages from the device in the import task that will be onboarded to AWS IoT Wireless.

DeviceName
Type: string

The name of the wireless device for which an import task is being started.

Sidewalk
Required: Yes
Type: SidewalkSingleStartImportInfo structure

The Sidewalk-related parameters for importing a single wireless device.

Tags
Type: Array of Tag structures

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The ARN (Amazon Resource Name) of the import task.

Id
Type: string

The import task ID.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

StartWirelessDeviceImportTask

$result = $client->startWirelessDeviceImportTask([/* ... */]);
$promise = $client->startWirelessDeviceImportTaskAsync([/* ... */]);

Start import task for provisioning Sidewalk devices in bulk using an S3 CSV file.

Parameter Syntax

$result = $client->startWirelessDeviceImportTask([
    'ClientRequestToken' => '<string>',
    'DestinationName' => '<string>', // REQUIRED
    'Sidewalk' => [ // REQUIRED
        'DeviceCreationFile' => '<string>',
        'Role' => '<string>',
    ],
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ClientRequestToken
Type: string

Each resource must have a unique client request token. The client token is used to implement idempotency. It ensures that the request completes no more than one time. If you retry a request with the same token and the same parameters, the request will complete successfully. However, if you try to create a new resource using the same token but different parameters, an HTTP 409 conflict occurs. If you omit this value, AWS SDKs will automatically generate a unique client request. For more information about idempotency, see Ensuring idempotency in Amazon EC2 API requests.

DestinationName
Required: Yes
Type: string

The name of the Sidewalk destination that describes the IoT rule to route messages from the devices in the import task that are onboarded to AWS IoT Wireless.

Sidewalk
Required: Yes
Type: SidewalkStartImportInfo structure

The Sidewalk-related parameters for importing wireless devices that need to be provisioned in bulk.

Tags
Type: Array of Tag structures

The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.

Result Syntax

[
    'Arn' => '<string>',
    'Id' => '<string>',
]

Result Details

Members
Arn
Type: string

The ARN (Amazon Resource Name) of the import task.

Id
Type: string

The import task ID.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

TagResource

$result = $client->tagResource([/* ... */]);
$promise = $client->tagResourceAsync([/* ... */]);

Adds a tag to a resource.

Parameter Syntax

$result = $client->tagResource([
    'ResourceArn' => '<string>', // REQUIRED
    'Tags' => [ // REQUIRED
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
ResourceArn
Required: Yes
Type: string

The ARN of the resource to add tags to.

Tags
Required: Yes
Type: Array of Tag structures

Adds to or modifies the tags of the given resource. Tags are metadata that you can use to manage a resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

TooManyTagsException:

The request was denied because the resource can't have any more tags.

TestWirelessDevice

$result = $client->testWirelessDevice([/* ... */]);
$promise = $client->testWirelessDeviceAsync([/* ... */]);

Simulates a provisioned device by sending an uplink data payload of Hello.

Parameter Syntax

$result = $client->testWirelessDevice([
    'Id' => '<string>', // REQUIRED
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The ID of the wireless device to test.

Result Syntax

[
    'Result' => '<string>',
]

Result Details

Members
Result
Type: string

The result returned by the test.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

UntagResource

$result = $client->untagResource([/* ... */]);
$promise = $client->untagResourceAsync([/* ... */]);

Removes one or more tags from a resource.

Parameter Syntax

$result = $client->untagResource([
    'ResourceArn' => '<string>', // REQUIRED
    'TagKeys' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
ResourceArn
Required: Yes
Type: string

The ARN of the resource to remove tags from.

TagKeys
Required: Yes
Type: Array of strings

A list of the keys of the tags to remove from the resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdateDestination

$result = $client->updateDestination([/* ... */]);
$promise = $client->updateDestinationAsync([/* ... */]);

Updates properties of a destination.

Parameter Syntax

$result = $client->updateDestination([
    'Description' => '<string>',
    'Expression' => '<string>',
    'ExpressionType' => 'RuleName|MqttTopic',
    'Name' => '<string>', // REQUIRED
    'RoleArn' => '<string>',
]);

Parameter Details

Members
Description
Type: string

A new description of the resource.

Expression
Type: string

The new rule name or topic rule to send messages to.

ExpressionType
Type: string

The type of value in Expression.

Name
Required: Yes
Type: string

The new name of the resource.

RoleArn
Type: string

The ARN of the IAM Role that authorizes the destination.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdateEventConfigurationByResourceTypes

$result = $client->updateEventConfigurationByResourceTypes([/* ... */]);
$promise = $client->updateEventConfigurationByResourceTypesAsync([/* ... */]);

Update the event configuration based on resource types.

Parameter Syntax

$result = $client->updateEventConfigurationByResourceTypes([
    'ConnectionStatus' => [
        'LoRaWAN' => [
            'WirelessGatewayEventTopic' => 'Enabled|Disabled',
        ],
    ],
    'DeviceRegistrationState' => [
        'Sidewalk' => [
            'WirelessDeviceEventTopic' => 'Enabled|Disabled',
        ],
    ],
    'Join' => [
        'LoRaWAN' => [
            'WirelessDeviceEventTopic' => 'Enabled|Disabled',
        ],
    ],
    'MessageDeliveryStatus' => [
        'Sidewalk' => [
            'WirelessDeviceEventTopic' => 'Enabled|Disabled',
        ],
    ],
    'Proximity' => [
        'Sidewalk' => [
            'WirelessDeviceEventTopic' => 'Enabled|Disabled',
        ],
    ],
]);

Parameter Details

Members
ConnectionStatus

Connection status resource type event configuration object for enabling and disabling wireless gateway topic.

DeviceRegistrationState

Device registration state resource type event configuration object for enabling and disabling wireless gateway topic.

Join

Join resource type event configuration object for enabling and disabling wireless device topic.

MessageDeliveryStatus

Message delivery status resource type event configuration object for enabling and disabling wireless device topic.

Proximity

Proximity resource type event configuration object for enabling and disabling wireless gateway topic.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

UpdateFuotaTask

$result = $client->updateFuotaTask([/* ... */]);
$promise = $client->updateFuotaTaskAsync([/* ... */]);

Updates properties of a FUOTA task.

Parameter Syntax

$result = $client->updateFuotaTask([
    'Description' => '<string>',
    'Descriptor' => '<string>',
    'FirmwareUpdateImage' => '<string>',
    'FirmwareUpdateRole' => '<string>',
    'FragmentIntervalMS' => <integer>,
    'FragmentSizeBytes' => <integer>,
    'Id' => '<string>', // REQUIRED
    'LoRaWAN' => [
        'RfRegion' => 'EU868|US915|AU915|AS923-1|AS923-2|AS923-3|AS923-4|EU433|CN470|CN779|RU864|KR920|IN865',
    ],
    'Name' => '<string>',
    'RedundancyPercent' => <integer>,
]);

Parameter Details

Members
Description
Type: string

The description of the new resource.

Descriptor
Type: string

The Descriptor specifies some metadata about the File being transferred using FUOTA e.g. the software version. It is sent transparently to the device. It is a binary field encoded in base64

FirmwareUpdateImage
Type: string

The S3 URI points to a firmware update image that is to be used with a FUOTA task.

FirmwareUpdateRole
Type: string

The firmware update role that is to be used with a FUOTA task.

FragmentIntervalMS
Type: int

The interval for sending fragments in milliseconds, rounded to the nearest second.

This interval only determines the timing for when the Cloud sends down the fragments to yor device. There can be a delay for when your device will receive these fragments. This delay depends on the device's class and the communication delay with the cloud.

FragmentSizeBytes
Type: int

The size of each fragment in bytes. This parameter is supported only for FUOTA tasks with multicast groups.

Id
Required: Yes
Type: string

The ID of a FUOTA task.

LoRaWAN
Type: LoRaWANFuotaTask structure

The LoRaWAN information used with a FUOTA task.

Name
Type: string

The name of a FUOTA task.

RedundancyPercent
Type: int

The percentage of the added fragments that are redundant. For example, if the size of the firmware image file is 100 bytes and the fragment size is 10 bytes, with RedundancyPercent set to 50(%), the final number of encoded fragments is (100 / 10) + (100 / 10 * 50%) = 15.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdateLogLevelsByResourceTypes

$result = $client->updateLogLevelsByResourceTypes([/* ... */]);
$promise = $client->updateLogLevelsByResourceTypesAsync([/* ... */]);

Set default log level, or log levels by resource types. This can be for wireless device log options or wireless gateways log options and is used to control the log messages that'll be displayed in CloudWatch.

Parameter Syntax

$result = $client->updateLogLevelsByResourceTypes([
    'DefaultLogLevel' => 'INFO|ERROR|DISABLED',
    'FuotaTaskLogOptions' => [
        [
            'Events' => [
                [
                    'Event' => 'Fuota', // REQUIRED
                    'LogLevel' => 'INFO|ERROR|DISABLED', // REQUIRED
                ],
                // ...
            ],
            'LogLevel' => 'INFO|ERROR|DISABLED', // REQUIRED
            'Type' => 'LoRaWAN', // REQUIRED
        ],
        // ...
    ],
    'WirelessDeviceLogOptions' => [
        [
            'Events' => [
                [
                    'Event' => 'Join|Rejoin|Uplink_Data|Downlink_Data|Registration', // REQUIRED
                    'LogLevel' => 'INFO|ERROR|DISABLED', // REQUIRED
                ],
                // ...
            ],
            'LogLevel' => 'INFO|ERROR|DISABLED', // REQUIRED
            'Type' => 'Sidewalk|LoRaWAN', // REQUIRED
        ],
        // ...
    ],
    'WirelessGatewayLogOptions' => [
        [
            'Events' => [
                [
                    'Event' => 'CUPS_Request|Certificate', // REQUIRED
                    'LogLevel' => 'INFO|ERROR|DISABLED', // REQUIRED
                ],
                // ...
            ],
            'LogLevel' => 'INFO|ERROR|DISABLED', // REQUIRED
            'Type' => 'LoRaWAN', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
DefaultLogLevel
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

FuotaTaskLogOptions
Type: Array of FuotaTaskLogOption structures

The list of fuota task log options.

WirelessDeviceLogOptions
Type: Array of WirelessDeviceLogOption structures

The list of wireless device log options.

WirelessGatewayLogOptions
Type: Array of WirelessGatewayLogOption structures

The list of wireless gateway log options.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ValidationException:

The input did not meet the specified constraints.

UpdateMetricConfiguration

$result = $client->updateMetricConfiguration([/* ... */]);
$promise = $client->updateMetricConfigurationAsync([/* ... */]);

Update the summary metric configuration.

Parameter Syntax

$result = $client->updateMetricConfiguration([
    'SummaryMetric' => [
        'Status' => 'Enabled|Disabled',
    ],
]);

Parameter Details

Members
SummaryMetric
Type: SummaryMetricConfiguration structure

The value to be used to set summary metric configuration.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdateMulticastGroup

$result = $client->updateMulticastGroup([/* ... */]);
$promise = $client->updateMulticastGroupAsync([/* ... */]);

Updates properties of a multicast group session.

Parameter Syntax

$result = $client->updateMulticastGroup([
    'Description' => '<string>',
    'Id' => '<string>', // REQUIRED
    'LoRaWAN' => [
        'DlClass' => 'ClassB|ClassC',
        'ParticipatingGateways' => [
            'GatewayList' => ['<string>', ...],
            'TransmissionInterval' => <integer>,
        ],
        'RfRegion' => 'EU868|US915|AU915|AS923-1|AS923-2|AS923-3|AS923-4|EU433|CN470|CN779|RU864|KR920|IN865',
    ],
    'Name' => '<string>',
]);

Parameter Details

Members
Description
Type: string

The description of the new resource.

Id
Required: Yes
Type: string

The ID of the multicast group.

LoRaWAN
Type: LoRaWANMulticast structure

The LoRaWAN information that is to be used with the multicast group.

Name
Type: string

The name of the multicast group.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdateNetworkAnalyzerConfiguration

$result = $client->updateNetworkAnalyzerConfiguration([/* ... */]);
$promise = $client->updateNetworkAnalyzerConfigurationAsync([/* ... */]);

Update network analyzer configuration.

Parameter Syntax

$result = $client->updateNetworkAnalyzerConfiguration([
    'ConfigurationName' => '<string>', // REQUIRED
    'Description' => '<string>',
    'MulticastGroupsToAdd' => ['<string>', ...],
    'MulticastGroupsToRemove' => ['<string>', ...],
    'TraceContent' => [
        'LogLevel' => 'INFO|ERROR|DISABLED',
        'MulticastFrameInfo' => 'ENABLED|DISABLED',
        'WirelessDeviceFrameInfo' => 'ENABLED|DISABLED',
    ],
    'WirelessDevicesToAdd' => ['<string>', ...],
    'WirelessDevicesToRemove' => ['<string>', ...],
    'WirelessGatewaysToAdd' => ['<string>', ...],
    'WirelessGatewaysToRemove' => ['<string>', ...],
]);

Parameter Details

Members
ConfigurationName
Required: Yes
Type: string

Name of the network analyzer configuration.

Description
Type: string

The description of the new resource.

MulticastGroupsToAdd
Type: Array of strings

Multicast group resources to add to the network analyzer configuration. Provide the MulticastGroupId of the resource to add in the input array.

MulticastGroupsToRemove
Type: Array of strings

Multicast group resources to remove from the network analyzer configuration. Provide the MulticastGroupId of the resources to remove in the input array.

TraceContent
Type: TraceContent structure

Trace content for your wireless devices, gateways, and multicast groups.

WirelessDevicesToAdd
Type: Array of strings

Wireless device resources to add to the network analyzer configuration. Provide the WirelessDeviceId of the resource to add in the input array.

WirelessDevicesToRemove
Type: Array of strings

Wireless device resources to remove from the network analyzer configuration. Provide the WirelessDeviceId of the resources to remove in the input array.

WirelessGatewaysToAdd
Type: Array of strings

Wireless gateway resources to add to the network analyzer configuration. Provide the WirelessGatewayId of the resource to add in the input array.

WirelessGatewaysToRemove
Type: Array of strings

Wireless gateway resources to remove from the network analyzer configuration. Provide the WirelessGatewayId of the resources to remove in the input array.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdatePartnerAccount

$result = $client->updatePartnerAccount([/* ... */]);
$promise = $client->updatePartnerAccountAsync([/* ... */]);

Updates properties of a partner account.

Parameter Syntax

$result = $client->updatePartnerAccount([
    'PartnerAccountId' => '<string>', // REQUIRED
    'PartnerType' => 'Sidewalk', // REQUIRED
    'Sidewalk' => [ // REQUIRED
        'AppServerPrivateKey' => '<string>',
    ],
]);

Parameter Details

Members
PartnerAccountId
Required: Yes
Type: string

The ID of the partner account to update.

PartnerType
Required: Yes
Type: string

The partner type.

Sidewalk
Required: Yes
Type: SidewalkUpdateAccount structure

The Sidewalk account credentials.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdatePosition

$result = $client->updatePosition([/* ... */]);
$promise = $client->updatePositionAsync([/* ... */]);

Update the position information of a resource.

This action is no longer supported. Calls to update the position information should use the UpdateResourcePosition API operation instead.

Parameter Syntax

$result = $client->updatePosition([
    'Position' => [<float>, ...], // REQUIRED
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => 'WirelessDevice|WirelessGateway', // REQUIRED
]);

Parameter Details

Members
Position
Required: Yes
Type: Array of floats

The position information of the resource.

ResourceIdentifier
Required: Yes
Type: string

Resource identifier of the resource for which position is updated.

ResourceType
Required: Yes
Type: string

Resource type of the resource for which position is updated.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

UpdateResourceEventConfiguration

$result = $client->updateResourceEventConfiguration([/* ... */]);
$promise = $client->updateResourceEventConfigurationAsync([/* ... */]);

Update the event configuration for a particular resource identifier.

Parameter Syntax

$result = $client->updateResourceEventConfiguration([
    'ConnectionStatus' => [
        'LoRaWAN' => [
            'GatewayEuiEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessGatewayIdEventTopic' => 'Enabled|Disabled',
    ],
    'DeviceRegistrationState' => [
        'Sidewalk' => [
            'AmazonIdEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
    ],
    'Identifier' => '<string>', // REQUIRED
    'IdentifierType' => 'PartnerAccountId|DevEui|FuotaTaskId|GatewayEui|WirelessDeviceId|WirelessGatewayId', // REQUIRED
    'Join' => [
        'LoRaWAN' => [
            'DevEuiEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
    ],
    'MessageDeliveryStatus' => [
        'Sidewalk' => [
            'AmazonIdEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
    ],
    'PartnerType' => 'Sidewalk',
    'Proximity' => [
        'Sidewalk' => [
            'AmazonIdEventTopic' => 'Enabled|Disabled',
        ],
        'WirelessDeviceIdEventTopic' => 'Enabled|Disabled',
    ],
]);

Parameter Details

Members
ConnectionStatus

Event configuration for the connection status event.

DeviceRegistrationState

Event configuration for the device registration state event.

Identifier
Required: Yes
Type: string

Resource identifier to opt in for event messaging.

IdentifierType
Required: Yes
Type: string

Identifier type of the particular resource identifier for event configuration.

Join
Type: JoinEventConfiguration structure

Event configuration for the join event.

MessageDeliveryStatus

Event configuration for the message delivery status event.

PartnerType
Type: string

Partner type of the resource if the identifier type is PartnerAccountId

Proximity
Type: ProximityEventConfiguration structure

Event configuration for the proximity event.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

UpdateResourcePosition

$result = $client->updateResourcePosition([/* ... */]);
$promise = $client->updateResourcePositionAsync([/* ... */]);

Update the position information of a given wireless device or a wireless gateway resource. The position coordinates are based on the World Geodetic System (WGS84).

Parameter Syntax

$result = $client->updateResourcePosition([
    'GeoJsonPayload' => <string || resource || Psr\Http\Message\StreamInterface>,
    'ResourceIdentifier' => '<string>', // REQUIRED
    'ResourceType' => 'WirelessDevice|WirelessGateway', // REQUIRED
]);

Parameter Details

Members
GeoJsonPayload
Type: blob (string|resource|Psr\Http\Message\StreamInterface)

The position information of the resource, displayed as a JSON payload. The payload uses the GeoJSON format, which a format that's used to encode geographic data structures. For more information, see GeoJSON.

ResourceIdentifier
Required: Yes
Type: string

The identifier of the resource for which position information is updated. It can be the wireless device ID or the wireless gateway ID, depending on the resource type.

ResourceType
Required: Yes
Type: string

The type of resource for which position information is updated, which can be a wireless device or a wireless gateway.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

InternalServerException:

An unexpected error occurred while processing a request.

UpdateWirelessDevice

$result = $client->updateWirelessDevice([/* ... */]);
$promise = $client->updateWirelessDeviceAsync([/* ... */]);

Updates properties of a wireless device.

Parameter Syntax

$result = $client->updateWirelessDevice([
    'Description' => '<string>',
    'DestinationName' => '<string>',
    'Id' => '<string>', // REQUIRED
    'LoRaWAN' => [
        'AbpV1_0_x' => [
            'FCntStart' => <integer>,
        ],
        'AbpV1_1' => [
            'FCntStart' => <integer>,
        ],
        'DeviceProfileId' => '<string>',
        'FPorts' => [
            'Applications' => [
                [
                    'DestinationName' => '<string>',
                    'FPort' => <integer>,
                    'Type' => 'SemtechGeolocation',
                ],
                // ...
            ],
            'Positioning' => [
                'ClockSync' => <integer>,
                'Gnss' => <integer>,
                'Stream' => <integer>,
            ],
        ],
        'ServiceProfileId' => '<string>',
    ],
    'Name' => '<string>',
    'Positioning' => 'Enabled|Disabled',
]);

Parameter Details

Members
Description
Type: string

A new description of the resource.

DestinationName
Type: string

The name of the new destination for the device.

Id
Required: Yes
Type: string

The ID of the resource to update.

LoRaWAN
Type: LoRaWANUpdateDevice structure

The updated wireless device's configuration.

Name
Type: string

The new name of the resource.

Positioning
Type: string

FPort values for the GNSS, stream, and ClockSync functions of the positioning information.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdateWirelessDeviceImportTask

$result = $client->updateWirelessDeviceImportTask([/* ... */]);
$promise = $client->updateWirelessDeviceImportTaskAsync([/* ... */]);

Update an import task to add more devices to the task.

Parameter Syntax

$result = $client->updateWirelessDeviceImportTask([
    'Id' => '<string>', // REQUIRED
    'Sidewalk' => [ // REQUIRED
        'DeviceCreationFile' => '<string>',
    ],
]);

Parameter Details

Members
Id
Required: Yes
Type: string

The identifier of the import task to be updated.

Sidewalk
Required: Yes
Type: SidewalkUpdateImportInfo structure

The Sidewalk-related parameters of the import task to be updated.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

AccessDeniedException:

User does not have permission to perform this action.

ResourceNotFoundException:

Resource does not exist.

InternalServerException:

An unexpected error occurred while processing a request.

ConflictException:

Adding, updating, or deleting the resource can cause an inconsistent state.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

UpdateWirelessGateway

$result = $client->updateWirelessGateway([/* ... */]);
$promise = $client->updateWirelessGatewayAsync([/* ... */]);

Updates properties of a wireless gateway.

Parameter Syntax

$result = $client->updateWirelessGateway([
    'Description' => '<string>',
    'Id' => '<string>', // REQUIRED
    'JoinEuiFilters' => [
        ['<string>', ...],
        // ...
    ],
    'MaxEirp' => <float>,
    'Name' => '<string>',
    'NetIdFilters' => ['<string>', ...],
]);

Parameter Details

Members
Description
Type: string

A new description of the resource.

Id
Required: Yes
Type: string

The ID of the resource to update.

JoinEuiFilters
Type: Array of stringss

A list of JoinEuiRange used by LoRa gateways to filter LoRa frames.

MaxEirp
Type: float

The MaxEIRP value.

Name
Type: string

The new name of the resource.

NetIdFilters
Type: Array of strings

A list of NetId values that are used by LoRa gateways to filter the uplink frames.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The input did not meet the specified constraints.

ResourceNotFoundException:

Resource does not exist.

AccessDeniedException:

User does not have permission to perform this action.

InternalServerException:

An unexpected error occurred while processing a request.

ThrottlingException:

The request was denied because it exceeded the allowed API request rate.

Shapes

AbpV1_0_x

Description

ABP device object for LoRaWAN specification v1.0.x

Members
DevAddr
Type: string

The DevAddr value.

FCntStart
Type: int

The FCnt init value.

SessionKeys
Type: SessionKeysAbpV1_0_x structure

Session keys for ABP v1.0.x

AbpV1_1

Description

ABP device object for LoRaWAN specification v1.1

Members
DevAddr
Type: string

The DevAddr value.

FCntStart
Type: int

The FCnt init value.

SessionKeys
Type: SessionKeysAbpV1_1 structure

Session keys for ABP v1.1

AccessDeniedException

Description

User does not have permission to perform this action.

Members
Message
Type: string

Accuracy

Description

The accuracy of the estimated position in meters. An empty value indicates that no position data is available. A value of ‘0.0’ value indicates that position data is available. This data corresponds to the position information that you specified instead of the position computed by solver.

Members
HorizontalAccuracy
Type: float

The horizontal accuracy of the estimated position, which is the difference between the estimated location and the actual device location.

VerticalAccuracy
Type: float

The vertical accuracy of the estimated position, which is the difference between the estimated altitude and actual device latitude in meters.

ApplicationConfig

Description

LoRaWAN application configuration, which can be used to perform geolocation.

Members
DestinationName
Type: string

The name of the position data destination that describes the AWS IoT rule that processes the device's position data for use by AWS IoT Core for LoRaWAN.

FPort
Type: int

The Fport value.

Type
Type: string

Application type, which can be specified to obtain real-time position information of your LoRaWAN device.

Beaconing

Description

Beaconing parameters for configuring the wireless gateways.

Members
DataRate
Type: int

The data rate for gateways that are sending the beacons.

Frequencies
Type: Array of ints

The frequency list for the gateways to send the beacons.

CdmaLocalId

Description

CDMA local ID information, which corresponds to the local identification parameters of a CDMA cell.

Members
CdmaChannel
Required: Yes
Type: int

CDMA channel information.

PnOffset
Required: Yes
Type: int

Pseudo-noise offset, which is a characteristic of the signal from a cell on a radio tower.

CdmaNmrObj

Description

CDMA object for network measurement reports.

Members
BaseStationId
Type: int

CDMA base station ID (BSID).

CdmaChannel
Required: Yes
Type: int

CDMA channel information.

PilotPower
Type: int

Transmit power level of the pilot signal, measured in dBm (decibel-milliwatts).

PnOffset
Required: Yes
Type: int

Pseudo-noise offset, which is a characteristic of the signal from a cell on a radio tower.

CdmaObj

Description

CDMA (Code-division multiple access) object.

Members
BaseLat
Type: float

CDMA base station latitude in degrees.

BaseLng
Type: float

CDMA base station longitude in degrees.

BaseStationId
Required: Yes
Type: int

CDMA base station ID (BSID).

CdmaLocalId
Type: CdmaLocalId structure

CDMA local identification (local ID) parameters.

CdmaNmr
Type: Array of CdmaNmrObj structures

CDMA network measurement reports.

NetworkId
Required: Yes
Type: int

CDMA network ID (NID).

PilotPower
Type: int

Transmit power level of the pilot signal, measured in dBm (decibel-milliwatts).

RegistrationZone
Type: int

CDMA registration zone (RZ).

SystemId
Required: Yes
Type: int

CDMA system ID (SID).

CellTowers

Description

The cell towers that were used to perform the measurements.

Members
Cdma
Type: Array of CdmaObj structures

CDMA object information.

Gsm
Type: Array of GsmObj structures

GSM object information.

Lte
Type: Array of LteObj structures

LTE object information.

Tdscdma
Type: Array of TdscdmaObj structures

TD-SCDMA object information.

Wcdma
Type: Array of WcdmaObj structures

WCDMA object information.

CertificateList

Description

List of sidewalk certificates.

Members
SigningAlg
Required: Yes
Type: string

The certificate chain algorithm provided by sidewalk.

Value
Required: Yes
Type: string

The value of the chosen sidewalk certificate.

ConflictException

Description

Adding, updating, or deleting the resource can cause an inconsistent state.

Members
Message
Type: string
ResourceId
Type: string

Id of the resource in the conflicting operation.

ResourceType
Type: string

Type of the resource in the conflicting operation.

ConnectionStatusEventConfiguration

Description

Connection status event configuration object for enabling or disabling topic.

Members
LoRaWAN

Connection status event configuration object for enabling or disabling LoRaWAN related event topics.

WirelessGatewayIdEventTopic
Type: string

Denotes whether the wireless gateway ID connection status event topic is enabled or disabled.

ConnectionStatusResourceTypeEventConfiguration

Description

Connection status resource type event configuration object for enabling or disabling topic.

Members
LoRaWAN

Connection status resource type event configuration object for enabling or disabling LoRaWAN related event topics.

DakCertificateMetadata

Description

The device attestation key (DAK) information.

Members
ApId
Type: string

The advertised product ID (APID) that's used for pre-production and production applications.

CertificateId
Required: Yes
Type: string

The certificate ID for the DAK.

DeviceTypeId
Type: string

The device type ID that's used for prototyping applications.

FactorySupport
Type: boolean

Whether factory support has been enabled.

MaxAllowedSignature
Type: int

The maximum number of signatures that the DAK can sign. A value of -1 indicates that there's no device limit.

Destinations

Description

Describes a destination.

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Description
Type: string

The description of the resource.

Expression
Type: string

The rule name or topic rule to send messages to.

ExpressionType
Type: string

The type of value in Expression.

Name
Type: string

The name of the resource.

RoleArn
Type: string

The ARN of the IAM Role that authorizes the destination.

DeviceProfile

Description

Describes a device profile.

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Id
Type: string

The ID of the device profile.

Name
Type: string

The name of the resource.

DeviceRegistrationStateEventConfiguration

Description

Device registration state event configuration object for enabling and disabling relevant topics.

Members
Sidewalk

Device registration state event configuration object for enabling or disabling Sidewalk related event topics.

WirelessDeviceIdEventTopic
Type: string

Denotes whether the wireless device ID device registration state event topic is enabled or disabled.

DeviceRegistrationStateResourceTypeEventConfiguration

Description

Device registration state resource type event configuration object for enabling or disabling topic.

Members
Sidewalk

Device registration resource type state event configuration object for enabling or disabling Sidewalk related event topics.

Dimension

Description

The required list of dimensions for the metric.

Members
name
Type: string

The name of the dimension.

value
Type: string

The dimension's value.

DownlinkQueueMessage

Description

The message in the downlink queue.

Members
LoRaWAN
Type: LoRaWANSendDataToDevice structure

LoRaWAN router info.

MessageId
Type: string

The message ID assigned by IoT Wireless to each downlink message, which helps identify the message.

ReceivedAt
Type: string

The time at which Iot Wireless received the downlink message.

TransmitMode
Type: int

The transmit mode to use for sending data to the wireless device. This can be 0 for UM (unacknowledge mode) or 1 for AM (acknowledge mode).

EventConfigurationItem

Description

Event configuration object for a single resource.

Members
Events

Object of all event configurations and the status of the event topics.

Identifier
Type: string

Resource identifier opted in for event messaging.

IdentifierType
Type: string

Identifier type of the particular resource identifier for event configuration.

PartnerType
Type: string

Partner type of the resource if the identifier type is PartnerAccountId.

EventNotificationItemConfigurations

Description

Object of all event configurations and the status of the event topics.

Members
ConnectionStatus

Connection status event configuration for an event configuration item.

DeviceRegistrationState

Device registration state event configuration for an event configuration item.

Join
Type: JoinEventConfiguration structure

Join event configuration for an event configuration item.

MessageDeliveryStatus

Message delivery status event configuration for an event configuration item.

Proximity
Type: ProximityEventConfiguration structure

Proximity event configuration for an event configuration item.

FPorts

Description

List of FPort assigned for different LoRaWAN application packages to use

Members
Applications
Type: Array of ApplicationConfig structures

Optional LoRaWAN application information, which can be used for geolocation.

ClockSync
Type: int

The Fport value.

Fuota
Type: int

The Fport value.

Multicast
Type: int

The Fport value.

Positioning
Type: Positioning structure

FPort values for the GNSS, stream, and ClockSync functions of the positioning information.

FuotaTask

Description

A FUOTA task.

Members
Arn
Type: string

The arn of a FUOTA task.

Id
Type: string

The ID of a FUOTA task.

Name
Type: string

The name of a FUOTA task.

FuotaTaskEventLogOption

Description

The log options for a FUOTA task event and can be used to set log levels for a specific fuota task event.

For a LoRaWAN FuotaTask type, possible event for a log message is Fuota.

Members
Event
Required: Yes
Type: string

The event for a log message, if the log message is tied to a fuota task.

LogLevel
Required: Yes
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

FuotaTaskLogOption

Description

The log options for fuota tasks and can be used to set log levels for a specific type of fuota task.

Members
Events
Type: Array of FuotaTaskEventLogOption structures

The list of FUOTA task event log options.

LogLevel
Required: Yes
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

Type
Required: Yes
Type: string

The fuota task type.

GatewayListItem

Description

Gateway list item object that specifies the frequency and list of gateways for which the downlink message should be sent.

Members
DownlinkFrequency
Required: Yes
Type: int

The frequency to use for the gateways when sending a downlink message to the wireless device.

GatewayId
Required: Yes
Type: string

The ID of the wireless gateways that you want to add to the list of gateways when sending downlink messages.

GlobalIdentity

Description

Global identity information.

Members
GeranCid
Required: Yes
Type: int

GERAN (GSM EDGE Radio Access Network) cell global identifier.

Lac
Required: Yes
Type: int

Location area code of the global identity.

Gnss

Description

Global navigation satellite system (GNSS) object used for positioning.

Members
AssistAltitude
Type: float

Optional assistance altitude, which is the altitude of the device at capture time, specified in meters above the WGS84 reference ellipsoid.

AssistPosition
Type: Array of floats

Optional assistance position information, specified using latitude and longitude values in degrees. The coordinates are inside the WGS84 reference frame.

CaptureTime
Type: float

Optional parameter that gives an estimate of the time when the GNSS scan information is taken, in seconds GPS time (GPST). If capture time is not specified, the local server time is used.

CaptureTimeAccuracy
Type: float

Optional value that gives the capture time estimate accuracy, in seconds. If capture time accuracy is not specified, default value of 300 is used.

Payload
Required: Yes
Type: string

Payload that contains the GNSS scan result, or NAV message, in hexadecimal notation.

Use2DSolver
Type: boolean

Optional parameter that forces 2D solve, which modifies the positioning algorithm to a 2D solution problem. When this parameter is specified, the assistance altitude should have an accuracy of at least 10 meters.

GsmLocalId

Description

GSM local ID information, which corresponds to the local identification parameters of a GSM cell.

Members
Bcch
Required: Yes
Type: int

GSM broadcast control channel.

Bsic
Required: Yes
Type: int

GSM base station identity code (BSIC).

GsmNmrObj

Description

GSM object for network measurement reports.

Members
Bcch
Required: Yes
Type: int

GSM broadcast control channel.

Bsic
Required: Yes
Type: int

GSM base station identity code (BSIC).

GlobalIdentity
Type: GlobalIdentity structure

Global identity information of the GSM object.

RxLevel
Type: int

Rx level, which is the received signal power, measured in dBm (decibel-milliwatts).

GsmObj

Description

GSM object.

Members
GeranCid
Required: Yes
Type: int

GERAN (GSM EDGE Radio Access Network) Cell Global Identifier.

GsmLocalId
Type: GsmLocalId structure

GSM local identification (local ID) information.

GsmNmr
Type: Array of GsmNmrObj structures

GSM object for network measurement reports.

GsmTimingAdvance
Type: int

Timing advance value, which corresponds to the length of time a signal takes to reach the base station from a mobile phone.

Lac
Required: Yes
Type: int

Location area code.

Mcc
Required: Yes
Type: int

Mobile Country Code.

Mnc
Required: Yes
Type: int

Mobile Network Code.

RxLevel
Type: int

Rx level, which is the received signal power, measured in dBm (decibel-milliwatts).

ImportedSidewalkDevice

Description

Information about a Sidewalk device that has been added to an import task.

Members
LastUpdateTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the status information was last updated.

OnboardingStatus
Type: string

The onboarding status of the Sidewalk device in the import task.

OnboardingStatusReason
Type: string

The reason for the onboarding status information for the Sidewalk device.

SidewalkManufacturingSn
Type: string

The Sidewalk manufacturing serial number (SMSN) of the Sidewalk device.

ImportedWirelessDevice

Description

Information about a wireless device that has been added to an import task.

Members
Sidewalk
Type: ImportedSidewalkDevice structure

The Sidewalk-related information about a device that has been added to an import task.

InternalServerException

Description

An unexpected error occurred while processing a request.

Members
Message
Type: string

Ip

Description

IP address used for resolving device location.

Members
IpAddress
Required: Yes
Type: string

IP address information.

JoinEventConfiguration

Description

Join event configuration object for enabling or disabling topic.

Members
LoRaWAN

Join event configuration object for enabling or disabling LoRaWAN related event topics.

WirelessDeviceIdEventTopic
Type: string

Denotes whether the wireless device ID join event topic is enabled or disabled.

JoinResourceTypeEventConfiguration

Description

Join resource type event configuration object for enabling or disabling topic.

Members
LoRaWAN

Join resource type event configuration object for enabling or disabling LoRaWAN related event topics.

LoRaWANConnectionStatusEventNotificationConfigurations

Description

Object for LoRaWAN connection status resource type event configuration.

Members
GatewayEuiEventTopic
Type: string

Denotes whether the gateway EUI connection status event topic is enabled or disabled.

LoRaWANConnectionStatusResourceTypeEventConfiguration

Description

Object for LoRaWAN connection status resource type event configuration.

Members
WirelessGatewayEventTopic
Type: string

Denotes whether the wireless gateway connection status event topic is enabled or disabled.

LoRaWANDevice

Description

LoRaWAN object for create functions.

Members
AbpV1_0_x
Type: AbpV1_0_x structure

LoRaWAN object for create APIs

AbpV1_1
Type: AbpV1_1 structure

ABP device object for create APIs for v1.1

DevEui
Type: string

The DevEUI value.

DeviceProfileId
Type: string

The ID of the device profile for the new wireless device.

FPorts
Type: FPorts structure

List of FPort assigned for different LoRaWAN application packages to use

OtaaV1_0_x
Type: OtaaV1_0_x structure

OTAA device object for create APIs for v1.0.x

OtaaV1_1
Type: OtaaV1_1 structure

OTAA device object for v1.1 for create APIs

ServiceProfileId
Type: string

The ID of the service profile.

LoRaWANDeviceMetadata

Description

LoRaWAN device metatdata.

Members
DataRate
Type: int

The DataRate value.

DevEui
Type: string

The DevEUI value.

FPort
Type: int

The FPort value.

Frequency
Type: int

The device's channel frequency in Hz.

Gateways
Type: Array of LoRaWANGatewayMetadata structures

Information about the gateways accessed by the device.

PublicGateways
Type: Array of LoRaWANPublicGatewayMetadata structures

Information about the LoRaWAN public network accessed by the device.

Timestamp
Type: string

The date and time of the metadata.

LoRaWANDeviceProfile

Description

LoRaWANDeviceProfile object.

Members
ClassBTimeout
Type: int

The ClassBTimeout value.

ClassCTimeout
Type: int

The ClassCTimeout value.

FactoryPresetFreqsList
Type: Array of ints

The list of values that make up the FactoryPresetFreqs value.

MacVersion
Type: string

The MAC version (such as OTAA 1.1 or OTAA 1.0.3) to use with this device profile.

MaxDutyCycle
Type: int

The MaxDutyCycle value. It ranges from 0 to 15.

MaxEirp
Type: int

The MaxEIRP value.

PingSlotDr
Type: int

The PingSlotDR value.

PingSlotFreq
Type: int

The PingSlotFreq value.

PingSlotPeriod
Type: int

The PingSlotPeriod value.

RegParamsRevision
Type: string

The version of regional parameters.

RfRegion
Type: string

The frequency band (RFRegion) value.

RxDataRate2
Type: int

The RXDataRate2 value.

RxDelay1
Type: int

The RXDelay1 value.

RxDrOffset1
Type: int

The RXDROffset1 value.

RxFreq2
Type: int

The RXFreq2 value.

Supports32BitFCnt
Type: boolean

The Supports32BitFCnt value.

SupportsClassB
Type: boolean

The SupportsClassB value.

SupportsClassC
Type: boolean

The SupportsClassC value.

SupportsJoin
Type: boolean

The SupportsJoin value.

LoRaWANFuotaTask

Description

The LoRaWAN information used with a FUOTA task.

Members
RfRegion
Type: string

Supported RfRegions

LoRaWANFuotaTaskGetInfo

Description

The LoRaWAN information returned from getting a FUOTA task.

Members
RfRegion
Type: string

The frequency band (RFRegion) value.

StartTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

Start time of a FUOTA task.

LoRaWANGateway

Description

LoRaWANGateway object.

Members
Beaconing
Type: Beaconing structure

Beaconing object information, which consists of the data rate and frequency parameters.

GatewayEui
Type: string

The gateway's EUI value.

JoinEuiFilters
Type: Array of stringss

A list of JoinEuiRange used by LoRa gateways to filter LoRa frames.

MaxEirp
Type: float

The MaxEIRP value.

NetIdFilters
Type: Array of strings

A list of NetId values that are used by LoRa gateways to filter the uplink frames.

RfRegion
Type: string

The frequency band (RFRegion) value.

SubBands
Type: Array of ints

A list of integer indicating which sub bands are supported by LoRa gateway.

LoRaWANGatewayCurrentVersion

Description

LoRaWANGatewayCurrentVersion object.

Members
CurrentVersion
Type: LoRaWANGatewayVersion structure

The version of the gateways that should receive the update.

LoRaWANGatewayMetadata

Description

LoRaWAN gateway metatdata.

Members
GatewayEui
Type: string

The gateway's EUI value.

Rssi
Type: double

The RSSI value.

Snr
Type: double

The SNR value.

LoRaWANGatewayVersion

Description

LoRaWANGatewayVersion object.

Members
Model
Type: string

The model number of the wireless gateway.

PackageVersion
Type: string

The version of the wireless gateway firmware.

Station
Type: string

The basic station version of the wireless gateway.

LoRaWANGetServiceProfileInfo

Description

LoRaWANGetServiceProfileInfo object.

Members
AddGwMetadata
Type: boolean

The AddGWMetaData value.

ChannelMask
Type: string

The ChannelMask value.

DevStatusReqFreq
Type: int

The DevStatusReqFreq value.

DlBucketSize
Type: int

The DLBucketSize value.

DlRate
Type: int

The DLRate value.

DlRatePolicy
Type: string

The DLRatePolicy value.

DrMax
Type: int

The DRMax value.

DrMin
Type: int

The DRMin value.

HrAllowed
Type: boolean

The HRAllowed value that describes whether handover roaming is allowed.

MinGwDiversity
Type: int

The MinGwDiversity value.

NwkGeoLoc
Type: boolean

The NwkGeoLoc value.

PrAllowed
Type: boolean

The PRAllowed value that describes whether passive roaming is allowed.

RaAllowed
Type: boolean

The RAAllowed value that describes whether roaming activation is allowed.

ReportDevStatusBattery
Type: boolean

The ReportDevStatusBattery value.

ReportDevStatusMargin
Type: boolean

The ReportDevStatusMargin value.

TargetPer
Type: int

The TargetPER value.

UlBucketSize
Type: int

The ULBucketSize value.

UlRate
Type: int

The ULRate value.

UlRatePolicy
Type: string

The ULRatePolicy value.

LoRaWANJoinEventNotificationConfigurations

Description

Object for LoRaWAN join resource type event configuration.

Members
DevEuiEventTopic
Type: string

Denotes whether the Dev EUI join event topic is enabled or disabled.

LoRaWANJoinResourceTypeEventConfiguration

Description

Object for LoRaWAN join resource type event configuration.

Members
WirelessDeviceEventTopic
Type: string

Denotes whether the wireless device join event topic is enabled or disabled.

LoRaWANListDevice

Description

LoRaWAN object for list functions.

Members
DevEui
Type: string

The DevEUI value.

LoRaWANMulticast

Description

The LoRaWAN information that is to be used with the multicast group.

Members
DlClass
Type: string

DlClass for LoRaWAM, valid values are ClassB and ClassC.

ParticipatingGateways

Specify the list of gateways to which you want to send the multicast downlink messages. The multicast message will be sent to each gateway in the sequence provided in the list.

RfRegion
Type: string

Supported RfRegions

LoRaWANMulticastGet

Description

The LoRaWAN information that is to be returned from getting multicast group information.

Members
DlClass
Type: string

DlClass for LoRaWAM, valid values are ClassB and ClassC.

NumberOfDevicesInGroup
Type: int

Number of devices that are associated to the multicast group.

NumberOfDevicesRequested
Type: int

Number of devices that are requested to be associated with the multicast group.

ParticipatingGateways

Specify the list of gateways to which you want to send the multicast downlink messages. The multicast message will be sent to each gateway in the sequence provided in the list.

RfRegion
Type: string

Supported RfRegions

LoRaWANMulticastMetadata

Description

The metadata information of the LoRaWAN multicast group.

Members
FPort
Type: int

The Fport value.

LoRaWANMulticastSession

Description

The LoRaWAN information used with the multicast session.

Members
DlDr
Type: int

Downlink data rate.

DlFreq
Type: int

Downlink frequency.

PingSlotPeriod
Type: int

The PingSlotPeriod value.

SessionStartTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

Timestamp of when the multicast group session is to start.

SessionTimeout
Type: int

How long before a multicast group session is to timeout.

LoRaWANPublicGatewayMetadata

Description

LoRaWAN public gateway metadata.

Members
DlAllowed
Type: boolean

Boolean that indicates whether downlink is allowed using the network.

Id
Type: string

The ID of the gateways that are operated by the network provider.

ProviderNetId
Type: string

The ID of the LoRaWAN public network provider.

RfRegion
Type: string

The frequency band (RFRegion) value.

Rssi
Type: double

The RSSI (received signal strength indicator) value.

Snr
Type: double

The SNR (signal to noise ratio) value.

LoRaWANSendDataToDevice

Description

LoRaWAN router info.

Members
FPort
Type: int

The Fport value.

ParticipatingGateways
Type: ParticipatingGateways structure

Choose the gateways that you want to use for the downlink data traffic when the wireless device is running in class B or class C mode.

LoRaWANServiceProfile

Description

LoRaWANServiceProfile object.

Members
AddGwMetadata
Type: boolean

The AddGWMetaData value.

DrMax
Type: int

The DrMax value.

DrMin
Type: int

The DrMin value.

PrAllowed
Type: boolean

The PRAllowed value that describes whether passive roaming is allowed.

RaAllowed
Type: boolean

The RAAllowed value that describes whether roaming activation is allowed.

LoRaWANStartFuotaTask

Description

The LoRaWAN information used to start a FUOTA task.

Members
StartTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

Start time of a FUOTA task.

LoRaWANUpdateDevice

Description

LoRaWAN object for update functions.

Members
AbpV1_0_x
Type: UpdateAbpV1_0_x structure

ABP device object for update APIs for v1.0.x

AbpV1_1
Type: UpdateAbpV1_1 structure

ABP device object for update APIs for v1.1

DeviceProfileId
Type: string

The ID of the device profile for the wireless device.

FPorts
Type: UpdateFPorts structure

FPorts object for the positioning information of the device.

ServiceProfileId
Type: string

The ID of the service profile.

LoRaWANUpdateGatewayTaskCreate

Description

LoRaWANUpdateGatewayTaskCreate object.

Members
CurrentVersion
Type: LoRaWANGatewayVersion structure

The version of the gateways that should receive the update.

SigKeyCrc
Type: long (int|float)

The CRC of the signature private key to check.

UpdateSignature
Type: string

The signature used to verify the update firmware.

UpdateVersion
Type: LoRaWANGatewayVersion structure

The firmware version to update the gateway to.

LoRaWANUpdateGatewayTaskEntry

Description

LoRaWANUpdateGatewayTaskEntry object.

Members
CurrentVersion
Type: LoRaWANGatewayVersion structure

The version of the gateways that should receive the update.

UpdateVersion
Type: LoRaWANGatewayVersion structure

The firmware version to update the gateway to.

LteLocalId

Description

LTE local identification (local ID) information.

Members
Earfcn
Required: Yes
Type: int

Evolved universal terrestrial radio access (E-UTRA) absolute radio frequency channel number (FCN).

Pci
Required: Yes
Type: int

Physical cell ID.

LteNmrObj

Description

LTE object for network measurement reports.

Members
Earfcn
Required: Yes
Type: int

E-UTRA (Evolved universal terrestrial Radio Access) absolute radio frequency channel Number (EARFCN).

EutranCid
Required: Yes
Type: int

E-UTRAN (Evolved Universal Terrestrial Radio Access Network) cell global identifier (EUTRANCID).

Pci
Required: Yes
Type: int

Physical cell ID.

Rsrp
Type: int

Signal power of the reference signal received, measured in dBm (decibel-milliwatts).

Rsrq
Type: float

Signal quality of the reference Signal received, measured in decibels (dB).

LteObj

Description

LTE object.

Members
EutranCid
Required: Yes
Type: int

E-UTRAN (Evolved Universal Terrestrial Radio Access Network) Cell Global Identifier.

LteLocalId
Type: LteLocalId structure

LTE local identification (local ID) information.

LteNmr
Type: Array of LteNmrObj structures

LTE object for network measurement reports.

LteTimingAdvance
Type: int

LTE timing advance.

Mcc
Required: Yes
Type: int

Mobile Country Code.

Mnc
Required: Yes
Type: int

Mobile Network Code.

NrCapable
Type: boolean

Parameter that determines whether the LTE object is capable of supporting NR (new radio).

Rsrp
Type: int

Signal power of the reference signal received, measured in dBm (decibel-milliwatts).

Rsrq
Type: float

Signal quality of the reference Signal received, measured in decibels (dB).

Tac
Type: int

LTE tracking area code.

MessageDeliveryStatusEventConfiguration

Description

Message delivery status event configuration object for enabling and disabling relevant topics.

Members
Sidewalk

SidewalkEventNotificationConfigurations object, which is the event configuration object for Sidewalk-related event topics.

WirelessDeviceIdEventTopic
Type: string

Denotes whether the wireless device ID message delivery status event topic is enabled or disabled.

MessageDeliveryStatusResourceTypeEventConfiguration

Description

Message delivery status resource type event configuration object for enabling or disabling relevant topic.

Members
Sidewalk

Sidewalk resource type event configuration object for enabling or disabling topic.

MetricQueryValue

Description

The aggregated values of the metric.

Members
Avg
Type: double

The average of the values of all data points collected during the aggregation period.

Max
Type: double

The maximum of the values of all the data points collected during the aggregation period.

Min
Type: double

The minimum of the values of all data points collected during the aggregation period.

P90
Type: double

The 90th percentile of the values of all data points collected during the aggregation period.

Std
Type: double

The standard deviation of the values of all data points collected during the aggregation period.

Sum
Type: double

The sum of the values of all data points collected during the aggregation period.

MulticastGroup

Description

A multicast group.

Members
Arn
Type: string

The arn of the multicast group.

Id
Type: string

The ID of the multicast group.

Name
Type: string

The name of the multicast group.

MulticastGroupByFuotaTask

Description

A multicast group that is associated with a FUOTA task.

Members
Id
Type: string

The ID of the multicast group.

MulticastWirelessMetadata

Description

Wireless metadata that is to be sent to multicast group.

Members
LoRaWAN
Type: LoRaWANMulticastMetadata structure

The metadata information of the LoRaWAN multicast group.

NetworkAnalyzerConfigurations

Description

Network analyzer configurations.

Members
Arn
Type: string

The Amazon Resource Name of the new resource.

Name
Type: string

Name of the network analyzer configuration.

OtaaV1_0_x

Description

OTAA device object for v1.0.x

Members
AppEui
Type: string

The AppEUI value. You specify this value when using LoRaWAN versions v1.0.2 or v1.0.3.

AppKey
Type: string

The AppKey value.

GenAppKey
Type: string

The GenAppKey value.

JoinEui
Type: string

The JoinEUI value. You specify this value instead of the AppEUI when using LoRaWAN version v1.0.4.

OtaaV1_1

Description

OTAA device object for v1.1

Members
AppKey
Type: string

The AppKey value.

JoinEui
Type: string

The JoinEUI value.

NwkKey
Type: string

The NwkKey value.

ParticipatingGateways

Description

Specify the list of gateways to which you want to send downlink data traffic when the wireless device is running in class B or class C mode.

Members
DownlinkMode
Required: Yes
Type: string

Indicates whether to send the downlink message in sequential mode or concurrent mode, or to use only the chosen gateways from the previous uplink message transmission.

GatewayList
Required: Yes
Type: Array of GatewayListItem structures

The list of gateways that you want to use for sending the downlink data traffic.

TransmissionInterval
Required: Yes
Type: int

The duration of time for which AWS IoT Core for LoRaWAN will wait before transmitting the payload to the next gateway.

ParticipatingGatewaysMulticast

Description

Specify the list of gateways to which you want to send the multicast downlink messages. The multicast message will be sent to each gateway in the sequence provided in the list.

Members
GatewayList
Type: Array of strings

The list of gateways that you want to use for sending the multicast downlink. Each downlink will be sent to all the gateways in the list with transmission interval between them. If list is empty the gateway list will be dynamically selected similar to the case of no ParticipatingGateways

TransmissionInterval
Type: int

The duration of time for which AWS IoT Core for LoRaWAN will wait before transmitting the multicast payload to the next gateway in the list.

PositionConfigurationItem

Description

The wrapper for a position configuration.

Members
Destination
Type: string

The position data destination that describes the AWS IoT rule that processes the device's position data for use by AWS IoT Core for LoRaWAN.

ResourceIdentifier
Type: string

Resource identifier for the position configuration.

ResourceType
Type: string

Resource type of the resource for the position configuration.

Solvers
Type: PositionSolverDetails structure

The details of the positioning solver object used to compute the location.

PositionSolverConfigurations

Description

The wrapper for position solver configurations.

Members
SemtechGnss
Type: SemtechGnssConfiguration structure

The Semtech GNSS solver configuration object.

PositionSolverDetails

Description

The wrapper for position solver details.

Members
SemtechGnss
Type: SemtechGnssDetail structure

The Semtech GNSS solver object details.

Positioning

Description

The FPorts for the position information.

Members
ClockSync
Type: int

The Fport value.

Gnss
Type: int

The Fport value.

Stream
Type: int

The Fport value.

ProximityEventConfiguration

Description

Proximity event configuration object for enabling and disabling relevant topics.

Members
Sidewalk

Proximity event configuration object for enabling or disabling Sidewalk related event topics.

WirelessDeviceIdEventTopic
Type: string

Denotes whether the wireless device ID proximity event topic is enabled or disabled.

ProximityResourceTypeEventConfiguration

Description

Proximity resource type event configuration object for enabling or disabling topic.

Members
Sidewalk

Proximity resource type event configuration object for enabling and disabling wireless device topic.

ResourceNotFoundException

Description

Resource does not exist.

Members
Message
Type: string
ResourceId
Type: string

Id of the not found resource.

ResourceType
Type: string

Type of the font found resource.

SemtechGnssConfiguration

Description

Information about the Semtech GNSS solver configuration.

Members
Fec
Required: Yes
Type: string

Whether forward error correction is enabled.

Status
Required: Yes
Type: string

The status indicating whether the solver is enabled.

SemtechGnssDetail

Description

Details of the Semtech GNSS solver object.

Members
Fec
Type: string

Whether forward error correction is enabled.

Provider
Type: string

The vendor of the solver object.

Status
Type: string

The status indicating whether the solver is enabled.

Type
Type: string

The type of positioning solver used.

ServiceProfile

Description

Information about a service profile.

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Id
Type: string

The ID of the service profile.

Name
Type: string

The name of the resource.

SessionKeysAbpV1_0_x

Description

Session keys for ABP v1.1

Members
AppSKey
Type: string

The AppSKey value.

NwkSKey
Type: string

The NwkSKey value.

SessionKeysAbpV1_1

Description

Session keys for ABP v1.1

Members
AppSKey
Type: string

The AppSKey value.

FNwkSIntKey
Type: string

The FNwkSIntKey value.

NwkSEncKey
Type: string

The NwkSEncKey value.

SNwkSIntKey
Type: string

The SNwkSIntKey value.

SidewalkAccountInfo

Description

Information about a Sidewalk account.

Members
AmazonId
Type: string

The Sidewalk Amazon ID.

AppServerPrivateKey
Type: string

The Sidewalk application server private key.

SidewalkAccountInfoWithFingerprint

Description

Information about a Sidewalk account.

Members
AmazonId
Type: string

The Sidewalk Amazon ID.

Arn
Type: string

The Amazon Resource Name of the resource.

Fingerprint
Type: string

The fingerprint of the Sidewalk application server private key.

SidewalkCreateDeviceProfile

Description

Sidewalk object for creating a device profile.

Members

SidewalkCreateWirelessDevice

Description

Sidewalk object for creating a wireless device.

Members
DeviceProfileId
Type: string

The ID of the Sidewalk device profile.

SidewalkDevice

Description

Sidewalk device object.

Members
AmazonId
Type: string

The Sidewalk Amazon ID.

CertificateId
Type: string

The ID of the Sidewalk device profile.

DeviceCertificates
Type: Array of CertificateList structures

The sidewalk device certificates for Ed25519 and P256r1.

DeviceProfileId
Type: string

The ID of the Sidewalk device profile.

PrivateKeys
Type: Array of CertificateList structures

The Sidewalk device private keys that will be used for onboarding the device.

SidewalkId
Type: string

The sidewalk device identification.

SidewalkManufacturingSn
Type: string

The Sidewalk manufacturing series number.

Status
Type: string

The Sidewalk device status, such as provisioned or registered.

SidewalkDeviceMetadata

Description

MetaData for Sidewalk device.

Members
BatteryLevel
Type: string

Sidewalk device battery level.

DeviceState
Type: string

Device state defines the device status of sidewalk device.

Event
Type: string

Sidewalk device status notification.

Rssi
Type: int

The RSSI value.

SidewalkEventNotificationConfigurations

Description

SidewalkEventNotificationConfigurations object, which is the event configuration object for Sidewalk-related event topics.

Members
AmazonIdEventTopic
Type: string

Denotes whether the Amazon ID event topic is enabled or disabled.

SidewalkGetDeviceProfile

Description

Gets information about a Sidewalk device profile.

Members
ApplicationServerPublicKey
Type: string

The Sidewalk application server public key.

DakCertificateMetadata
Type: Array of DakCertificateMetadata structures

The DAK certificate information of the Sidewalk device profile.

QualificationStatus
Type: boolean

Gets information about the certification status of a Sidewalk device profile.

SidewalkGetStartImportInfo

Description

Sidewalk-related information for devices in an import task that are being onboarded.

Members
DeviceCreationFileList
Type: Array of strings

List of Sidewalk devices that are added to the import task.

Role
Type: string

The IAM role that allows AWS IoT Wireless to access the CSV file in the S3 bucket.

SidewalkListDevice

Description

Sidewalk object used by list functions.

Members
AmazonId
Type: string

The Sidewalk Amazon ID.

DeviceCertificates
Type: Array of CertificateList structures

The sidewalk device certificates for Ed25519 and P256r1.

DeviceProfileId
Type: string

Sidewalk object used by list functions.

SidewalkId
Type: string

The sidewalk device identification.

SidewalkManufacturingSn
Type: string

The Sidewalk manufacturing series number.

Status
Type: string

The status of the Sidewalk devices, such as provisioned or registered.

SidewalkResourceTypeEventConfiguration

Description

Sidewalk resource type event configuration object for enabling or disabling topic.

Members
WirelessDeviceEventTopic
Type: string

Denotes whether the wireless device join event topic is enabled or disabled.

SidewalkSendDataToDevice

Description

Information about a Sidewalk router.

Members
AckModeRetryDurationSecs
Type: int

The duration of time in seconds to retry sending the ACK.

MessageType
Type: string

Sidewalk device message type. Default value is CUSTOM_COMMAND_ID_NOTIFY.

Seq
Type: int

The sequence number.

SidewalkSingleStartImportInfo

Description

Information about an import task created for an individual Sidewalk device.

Members
SidewalkManufacturingSn
Type: string

The Sidewalk manufacturing serial number (SMSN) of the device added to the import task.

SidewalkStartImportInfo

Description

Information about an import task created for bulk provisioning.

Members
DeviceCreationFile
Type: string

The CSV file contained in an S3 bucket that's used for adding devices to an import task.

Role
Type: string

The IAM role that allows AWS IoT Wireless to access the CSV file in the S3 bucket.

SidewalkUpdateAccount

Description

Sidewalk update.

Members
AppServerPrivateKey
Type: string

The new Sidewalk application server private key.

SidewalkUpdateImportInfo

Description

Sidewalk object information for updating an import task.

Members
DeviceCreationFile
Type: string

The CSV file contained in an S3 bucket that's used for appending devices to an existing import task.

SummaryMetricConfiguration

Description

The configuration of summary metrics.

Members
Status
Type: string

The status of the configuration of summary metrics.

SummaryMetricQuery

Description

The summary metric query object.

Members
AggregationPeriod
Type: string

The aggregation period of the summary metric.

Dimensions
Type: Array of Dimension structures

The dimensions of the summary metric.

EndTimestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The end timestamp for the summary metric query.

MetricName
Type: string

The name of the metric.

QueryId
Type: string

The id of the summary metric query.

StartTimestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The start timestamp for the summary metric query.

SummaryMetricQueryResult

Description

The result of the summary metrics aggregation operation.

Members
AggregationPeriod
Type: string

The aggregation period of the metric.

Dimensions
Type: Array of Dimension structures

The dimensions of the metric.

EndTimestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The end timestamp for the summary metric query.

Error
Type: string

The error message for the summary metric query result.

MetricName
Type: string

The name of the summary metric query result.

QueryId
Type: string

The ID of the summary metric results query operation.

QueryStatus
Type: string

The status of the summary metric query result.

StartTimestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The start timestamp for the summary metric query.

Timestamps
Type: Array of timestamp (string|DateTime or anything parsable by strtotime)s

The timestamp of each aggregation result.

Unit
Type: string

The units of measurement to be used for interpreting the aggregation result.

Values
Type: Array of MetricQueryValue structures

The list of aggregated summary metric query results.

Tag

Description

A simple label consisting of a customer-defined key-value pair

Members
Key
Required: Yes
Type: string

The tag's key value.

Value
Required: Yes
Type: string

The tag's value.

TdscdmaLocalId

Description

TD-SCDMA local identification (local Id) information.

Members
CellParams
Required: Yes
Type: int

Cell parameters for TD-SCDMA.

Uarfcn
Required: Yes
Type: int

TD-SCDMA UTRA (Universal Terrestrial Radio Access Network) absolute RF channel number (UARFCN).

TdscdmaNmrObj

Description

TD-SCDMA object for network measurement reports.

Members
CellParams
Required: Yes
Type: int

Cell parameters for TD-SCDMA network measurement reports object.

PathLoss
Type: int

Path loss, or path attenuation, is the reduction in power density of an electromagnetic wave as it propagates through space.

Rscp
Type: int

Code power of the received signal, measured in decibel-milliwatts (dBm).

Uarfcn
Required: Yes
Type: int

TD-SCDMA UTRA (Universal Terrestrial Radio Access Network) absolute RF channel number.

UtranCid
Type: int

UTRAN (UMTS Terrestrial Radio Access Network) cell global identifier.

TdscdmaObj

Description

TD-SCDMA object.

Members
Lac
Type: int

Location Area Code.

Mcc
Required: Yes
Type: int

Mobile Country Code.

Mnc
Required: Yes
Type: int

Mobile Network Code.

PathLoss
Type: int

Path loss, or path attenuation, is the reduction in power density of an electromagnetic wave as it propagates through space.

Rscp
Type: int

Signal power of the received signal (Received Signal Code Power), measured in decibel-milliwatts (dBm).

TdscdmaLocalId
Type: TdscdmaLocalId structure

TD-SCDMA local identification (local ID) information.

TdscdmaNmr
Type: Array of TdscdmaNmrObj structures

TD-SCDMA object for network measurement reports.

TdscdmaTimingAdvance
Type: int

TD-SCDMA Timing advance.

UtranCid
Required: Yes
Type: int

UTRAN (UMTS Terrestrial Radio Access Network) Cell Global Identifier.

ThrottlingException

Description

The request was denied because it exceeded the allowed API request rate.

Members
Message
Type: string

TooManyTagsException

Description

The request was denied because the resource can't have any more tags.

Members
Message
Type: string
ResourceName
Type: string

Name of the resource that exceeds maximum number of tags allowed.

TraceContent

Description

Trace content for your wireless devices, gateways, and multicast groups.

Members
LogLevel
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

MulticastFrameInfo
Type: string

FrameInfo of your multicast group resources for the trace content. Use FrameInfo to debug the multicast communication between your multicast groups and the network server.

WirelessDeviceFrameInfo
Type: string

FrameInfo of your wireless device resources for the trace content. Use FrameInfo to debug the communication between your LoRaWAN end devices and the network server.

UpdateAbpV1_0_x

Description

ABP device object for LoRaWAN specification v1.0.x

Members
FCntStart
Type: int

The FCnt init value.

UpdateAbpV1_1

Description

ABP device object for LoRaWAN specification v1.1

Members
FCntStart
Type: int

The FCnt init value.

UpdateFPorts

Description

Object for updating the FPorts information.

Members
Applications
Type: Array of ApplicationConfig structures

LoRaWAN application, which can be used for geolocation by activating positioning.

Positioning
Type: Positioning structure

Positioning FPorts for the ClockSync, Stream, and GNSS functions.

UpdateWirelessGatewayTaskCreate

Description

UpdateWirelessGatewayTaskCreate object.

Members
LoRaWAN

The properties that relate to the LoRaWAN wireless gateway.

UpdateDataRole
Type: string

The IAM role used to read data from the S3 bucket.

UpdateDataSource
Type: string

The link to the S3 bucket.

UpdateWirelessGatewayTaskEntry

Description

UpdateWirelessGatewayTaskEntry object.

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Id
Type: string

The ID of the new wireless gateway task entry.

LoRaWAN

The properties that relate to the LoRaWAN wireless gateway.

ValidationException

Description

The input did not meet the specified constraints.

Members
Message
Type: string

WcdmaLocalId

Description

WCDMA local identification (local ID) information.

Members
Psc
Required: Yes
Type: int

Primary Scrambling Code.

Uarfcndl
Required: Yes
Type: int

WCDMA UTRA Absolute RF Channel Number downlink.

WcdmaNmrObj

Description

Network Measurement Reports.

Members
PathLoss
Type: int

Path loss, or path attenuation, is the reduction in power density of an electromagnetic wave as it propagates through space.

Psc
Required: Yes
Type: int

Primary Scrambling Code.

Rscp
Type: int

Received Signal Code Power (signal power) (dBm)

Uarfcndl
Required: Yes
Type: int

WCDMA UTRA Absolute RF Channel Number downlink.

UtranCid
Required: Yes
Type: int

UTRAN (UMTS Terrestrial Radio Access Network) Cell Global Identifier.

WcdmaObj

Description

WCDMA.

Members
Lac
Type: int

Location Area Code.

Mcc
Required: Yes
Type: int

Mobile Country Code.

Mnc
Required: Yes
Type: int

Mobile Network Code.

PathLoss
Type: int

Path loss, or path attenuation, is the reduction in power density of an electromagnetic wave as it propagates through space.

Rscp
Type: int

Received Signal Code Power (signal power) (dBm).

UtranCid
Required: Yes
Type: int

UTRAN (UMTS Terrestrial Radio Access Network) Cell Global Identifier.

WcdmaLocalId
Type: WcdmaLocalId structure

WCDMA local ID information.

WcdmaNmr
Type: Array of WcdmaNmrObj structures

WCDMA object for network measurement reports.

WiFiAccessPoint

Description

Wi-Fi access point.

Members
MacAddress
Required: Yes
Type: string

Wi-Fi MAC Address.

Rss
Required: Yes
Type: int

Received signal strength (dBm) of the WLAN measurement data.

WirelessDeviceEventLogOption

Description

The log options for a wireless device event and can be used to set log levels for a specific wireless device event.

For a LoRaWAN device, possible events for a log messsage are: Join, Rejoin, Downlink_Data, and Uplink_Data. For a Sidewalk device, possible events for a log message are Registration, Downlink_Data, and Uplink_Data.

Members
Event
Required: Yes
Type: string

The event for a log message, if the log message is tied to a wireless device.

LogLevel
Required: Yes
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

WirelessDeviceImportTask

Description

Information about an import task for wireless devices.

Members
Arn
Type: string

The ARN (Amazon Resource Name) of the wireless device import task.

CreationTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the import task was created.

DestinationName
Type: string

The name of the Sidewalk destination that that describes the IoT rule to route messages from the device in the import task that will be onboarded to AWS IoT Wireless

FailedImportedDeviceCount
Type: long (int|float)

The summary information of count of wireless devices in an import task that failed to onboarded to the import task.

Id
Type: string

The ID of the wireless device import task.

InitializedImportedDeviceCount
Type: long (int|float)

The summary information of count of wireless devices that are waiting for the control log to be added to an import task.

OnboardedImportedDeviceCount
Type: long (int|float)

The summary information of count of wireless devices in an import task that have been onboarded to the import task.

PendingImportedDeviceCount
Type: long (int|float)

The summary information of count of wireless devices in an import task that are waiting in the queue to be onboarded.

Sidewalk
Type: SidewalkGetStartImportInfo structure

The Sidewalk-related information of the wireless device import task.

Status
Type: string

The status information of the wireless device import task.

StatusReason
Type: string

The reason that provides additional information about the import task status.

WirelessDeviceLogOption

Description

The log options for wireless devices and can be used to set log levels for a specific type of wireless device.

Members
Events
Type: Array of WirelessDeviceEventLogOption structures

The list of wireless device event log options.

LogLevel
Required: Yes
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

Type
Required: Yes
Type: string

The wireless device type.

WirelessDeviceStatistics

Description

Information about a wireless device's operation.

Members
Arn
Type: string

The Amazon Resource Name of the resource.

DestinationName
Type: string

The name of the destination to which the device is assigned.

FuotaDeviceStatus
Type: string

The status of a wireless device in a FUOTA task.

Id
Type: string

The ID of the wireless device reporting the data.

LastUplinkReceivedAt
Type: string

The date and time when the most recent uplink was received.

Theis value is only valid for 3 months.

LoRaWAN
Type: LoRaWANListDevice structure

LoRaWAN device info.

McGroupId
Type: int

Id of the multicast group.

MulticastDeviceStatus
Type: string

The status of the wireless device in the multicast group.

Name
Type: string

The name of the resource.

Sidewalk
Type: SidewalkListDevice structure

The Sidewalk account credentials.

Type
Type: string

The wireless device type.

WirelessGatewayEventLogOption

Description

The log options for a wireless gateway event and can be used to set log levels for a specific wireless gateway event.

For a LoRaWAN gateway, possible events for a log message are CUPS_Request and Certificate.

Members
Event
Required: Yes
Type: string

The event for a log message, if the log message is tied to a wireless gateway.

LogLevel
Required: Yes
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

WirelessGatewayLogOption

Description

The log options for wireless gateways and can be used to set log levels for a specific type of wireless gateway.

Members
Events
Type: Array of WirelessGatewayEventLogOption structures

The list of wireless gateway event log options.

LogLevel
Required: Yes
Type: string

The log level for a log message. The log levels can be disabled, or set to ERROR to display less verbose logs containing only error information, or to INFO for more detailed logs.

Type
Required: Yes
Type: string

The wireless gateway type.

WirelessGatewayStatistics

Description

Information about a wireless gateway's operation.

Members
Arn
Type: string

The Amazon Resource Name of the resource.

Description
Type: string

The description of the resource.

Id
Type: string

The ID of the wireless gateway reporting the data.

LastUplinkReceivedAt
Type: string

The date and time when the most recent uplink was received.

This value is only valid for 3 months.

LoRaWAN
Type: LoRaWANGateway structure

LoRaWAN gateway info.

Name
Type: string

The name of the resource.