Поделиться через


Topics - Get

Возвращает описание указанного раздела.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName}?api-version=2024-01-01

Параметры URI

Имя В Обязательно Тип Описание
namespaceName
path True

string

minLength: 6
maxLength: 50

Имя пространства имен

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не учитывает регистр.

subscriptionId
path True

string

Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.

topicName
path True

string

minLength: 1

Имя раздела.

api-version
query True

string

minLength: 1

Версия API, используемая для этой операции.

Ответы

Имя Тип Описание
200 OK

SBTopic

Описание раздела успешно получено.

Other Status Codes

ErrorResponse

Ответ об ошибке ServiceBus, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

TopicGet

Образец запроса

GET https://management.azure.com/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-1617/topics/sdk-Topics-5488?api-version=2024-01-01

Пример ответа

{
  "id": "/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-1617/topics/sdk-Topics-5488",
  "name": "sdk-Topics-5488",
  "type": "Microsoft.ServiceBus/Namespaces/Topics",
  "properties": {
    "defaultMessageTimeToLive": "P10675199DT2H48M5.4775807S",
    "maxSizeInMegabytes": 10240,
    "maxMessageSizeInKilobytes": 10240,
    "requiresDuplicateDetection": false,
    "duplicateDetectionHistoryTimeWindow": "PT10M",
    "enableBatchedOperations": true,
    "sizeInBytes": 0,
    "status": "Active",
    "supportOrdering": true,
    "autoDeleteOnIdle": "P10675199DT2H48M5.4775807S",
    "enablePartitioning": false,
    "enableExpress": true,
    "createdAt": "2017-05-26T20:50:31.4442694Z",
    "updatedAt": "2017-05-26T20:52:32.2092264Z",
    "accessedAt": "0001-01-01T00:00:00Z",
    "subscriptionCount": 0
  }
}

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.

EntityStatus

Состояние сущности.

Error

Объект ошибки.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorResponse

Ответ об ошибке управления ресурсами.

MessageCountDetails

Сведения о счетчике сообщений.

SBTopic

Описание ресурса раздела.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
Application
Key
ManagedIdentity
User

EntityStatus

Состояние сущности.

Значение Описание
Active
Creating
Deleting
Disabled
ReceiveDisabled
Renaming
Restoring
SendDisabled
Unknown

Error

Объект ошибки.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorResponse[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorResponse

Ответ об ошибке управления ресурсами.

Имя Тип Описание
error

Error

Объект ошибки.

MessageCountDetails

Сведения о счетчике сообщений.

Имя Тип Описание
activeMessageCount

integer (int64)

Количество активных сообщений в очереди, разделе или подписке.

deadLetterMessageCount

integer (int64)

Число сообщений, которые являются недоставленными.

scheduledMessageCount

integer (int64)

Количество запланированных сообщений.

transferDeadLetterMessageCount

integer (int64)

Количество сообщений, передаваемых в мертвые буквы.

transferMessageCount

integer (int64)

Количество сообщений, передаваемых в другую очередь, раздел или подписку.

SBTopic

Описание ресурса раздела.

Имя Тип Описание
id

string

Полный идентификатор ресурса для ресурса. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса

properties.accessedAt

string (date-time)

При последнем отправке сообщения или получении запроса для этого раздела.

properties.autoDeleteOnIdle

string (duration)

Интервал простоя интервала времени ISO 8601, после которого раздел автоматически удаляется. Минимальная длительность составляет 5 минут.

properties.countDetails

MessageCountDetails

Сведения о подсчете сообщений

properties.createdAt

string (date-time)

Точное время создания сообщения.

properties.defaultMessageTimeToLive

string (duration)

Время ожидания сообщения ISO 8601 по умолчанию для динамического значения. Это длительность, после которой истекает срок действия сообщения, начиная с момента отправки сообщения в служебную шину. Это значение по умолчанию, используемое, если TimeToLive не задан в самом сообщении.

properties.duplicateDetectionHistoryTimeWindow

string (duration)

ISO8601 структура интервала времени, определяющая длительность журнала обнаружения дубликата. Значение по умолчанию равно 10 минутам.

properties.enableBatchedOperations

boolean

Значение, указывающее, включены ли пакетные операции на стороне сервера.

properties.enableExpress

boolean

Значение, указывающее, включены ли экспресс-сущности. Экспресс-раздел содержит сообщение в памяти временно перед записью в постоянное хранилище.

properties.enablePartitioning

boolean

Значение, указывающее, включена ли секция между несколькими брокерами сообщений.

properties.maxMessageSizeInKilobytes

integer (int64)

Максимальный размер (в КБ) полезных данных сообщения, которые можно принять в разделе. Это свойство используется только в Premium сегодня, а по умолчанию — 1024.

properties.maxSizeInMegabytes

integer (int32)

Максимальный размер раздела в мегабайтах, который является размером памяти, выделенной для раздела. Значение по умолчанию — 1024.

properties.requiresDuplicateDetection

boolean

Значение, указывающее, требуется ли для этого раздела обнаружение повторяющихся данных.

properties.sizeInBytes

integer (int64)

Размер раздела в байтах.

properties.status

EntityStatus

Перечисляет возможные значения состояния сущности обмена сообщениями.

properties.subscriptionCount

integer (int32)

Количество подписок.

properties.supportOrdering

boolean

Значение, указывающее, поддерживает ли раздел упорядочение.

properties.updatedAt

string (date-time)

Точное время обновления сообщения.

systemData

systemData

Системные метаданные, относящиеся к этому ресурсу.

type

string

Тип ресурса. Например, "Microsoft.EventHub/Namespaces" или "Microsoft.EventHub/Namespaces/EventHubs"

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Тип удостоверения, который последний раз изменил ресурс.

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.