Topics - Get
Возвращает описание указанного раздела.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName}?api-version=2024-01-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
namespace
|
path | True |
string minLength: 6maxLength: 50 |
Имя пространства имен |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя не учитывает регистр. |
subscription
|
path | True |
string |
Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы. |
topic
|
path | True |
string minLength: 1 |
Имя раздела. |
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для этой операции. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Описание раздела успешно получено. |
|
Other Status Codes |
Ответ об ошибке ServiceBus, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
TopicGet
Образец запроса
Пример ответа
{
"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
}
}
Определения
Имя | Описание |
---|---|
created |
Тип удостоверения, создавшего ресурс. |
Entity |
Состояние сущности. |
Error |
Объект ошибки. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Ответ об ошибке управления ресурсами. |
Message |
Сведения о счетчике сообщений. |
SBTopic |
Описание ресурса раздела. |
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
createdByType
Тип удостоверения, создавшего ресурс.
Значение | Описание |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
EntityStatus
Состояние сущности.
Значение | Описание |
---|---|
Active | |
Creating | |
Deleting | |
Disabled | |
ReceiveDisabled | |
Renaming | |
Restoring | |
SendDisabled | |
Unknown |
Error
Объект ошибки.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Дополнительный тип сведений. |
ErrorResponse
Ответ об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
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 |
Сведения о подсчете сообщений |
|
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 |
Перечисляет возможные значения состояния сущности обмена сообщениями. |
|
properties.subscriptionCount |
integer (int32) |
Количество подписок. |
properties.supportOrdering |
boolean |
Значение, указывающее, поддерживает ли раздел упорядочение. |
properties.updatedAt |
string (date-time) |
Точное время обновления сообщения. |
systemData |
Системные метаданные, относящиеся к этому ресурсу. |
|
type |
string |
Тип ресурса. Например, "Microsoft.EventHub/Namespaces" или "Microsoft.EventHub/Namespaces/EventHubs" |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
Имя | Тип | Описание |
---|---|---|
createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
createdBy |
string |
Удостоверение, создающее ресурс. |
createdByType |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string (date-time) |
Тип удостоверения, который последний раз изменил ресурс. |
lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |