Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex IoT Core
  • Access management
  • Pricing policy
  • Terraform reference
    • Authentication with the API
      • Overview
        • Overview
        • Get
        • GetByName
        • List
        • Create
        • Update
        • Delete
        • ListCertificates
        • AddCertificate
        • DeleteCertificate
        • ListPasswords
        • AddPassword
        • DeletePassword
        • ListDeviceTopicAliases
        • ListDataStreamExports
        • AddDataStreamExport
        • DeleteDataStreamExport
        • ListOperations
        • Disable
        • Enable
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  • FAQ

In this article:

  • gRPC request
  • ListDeviceTopicAliasesRequest
  • ListDeviceTopicAliasesResponse
  • DeviceAlias
  1. Devices API reference
  2. gRPC
  3. Registry
  4. ListDeviceTopicAliases

IoT Core Service, gRPC: RegistryService.ListDeviceTopicAliases

Written by
Yandex Cloud
Updated at November 26, 2024
  • gRPC request
  • ListDeviceTopicAliasesRequest
  • ListDeviceTopicAliasesResponse
  • DeviceAlias

Retrieves the list of device topic aliases for the specified registry.

gRPC request

rpc ListDeviceTopicAliases (ListDeviceTopicAliasesRequest) returns (ListDeviceTopicAliasesResponse)

ListDeviceTopicAliasesRequest

{
  "registry_id": "string",
  "page_size": "int64",
  "page_token": "string"
}

Field

Description

registry_id

string

Required field. ID of the registry to list aliases for device topic.

To get a registry ID make a RegistryService.List request.

page_size

int64

The maximum number of results per page that should be returned. If the number of available
results is larger than page_size, the service returns a ListDeviceTopicAliasesResponse.next_page_token
that can be used to get the next page of results in subsequent list requests.
Default value: 100.

page_token

string

Page token. To get the next page of results, set page_token to the
ListDeviceTopicAliasesResponse.next_page_token returned by a previous list request.

ListDeviceTopicAliasesResponse

{
  "aliases": [
    {
      "device_id": "string",
      "topic_prefix": "string",
      "alias": "string"
    }
  ],
  "next_page_token": "string"
}

Field

Description

aliases[]

DeviceAlias

List of device aliases for the specified registry.

next_page_token

string

Token for getting the next page of the list. If the number of results is greater than
the specified ListDeviceTopicAliasesRequest.page_size, use next_page_token as the value
for the ListDeviceTopicAliasesRequest.page_token parameter in the next list request.

Each subsequent page will have its own next_page_token to continue paging through the results.

DeviceAlias

A device topic alias.

Alias is an alternate name of a device topic assigned by the user. Map alias to canonical topic name prefix, e.g. my/custom/alias match to $device/abcdef/events. For more information, see Using topic aliases.

Field

Description

device_id

string

ID of the device that the alias belongs to.

topic_prefix

string

Prefix of a canonical topic name to be aliased, e.g. $devices/abcdef.

alias

string

Alias of a device topic.

Was the article helpful?

Previous
DeletePassword
Next
ListDataStreamExports
© 2025 Direct Cursus Technology L.L.C.