你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Queues - Get
返回指定队列的说明。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues/{queueName}?api-version=2021-11-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
namespace
|
path | True |
string |
命名空间名称 |
queue
|
path | True |
string |
队列名称。 |
resource
|
path | True |
string |
Azure 订阅中的资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
已成功返回队列说明。 |
|
Other Status Codes |
描述操作失败原因的 ServiceBus 错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
QueueGet
Sample Request
GET https://management.azure.com/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-3174/queues/sdk-Queues-5647?api-version=2021-11-01
Sample Response
{
"id": "/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-3174/queues/sdk-Queues-5647",
"name": "sdk-Queues-5647",
"type": "Microsoft.ServiceBus/Namespaces/Queues",
"properties": {
"lockDuration": "PT1M",
"maxSizeInMegabytes": 163840,
"maxMessageSizeInKilobytes": 10240,
"requiresDuplicateDetection": false,
"requiresSession": false,
"defaultMessageTimeToLive": "P10675199DT2H48M5.4775807S",
"duplicateDetectionHistoryTimeWindow": "PT10M",
"maxDeliveryCount": 10,
"sizeInBytes": 0,
"messageCount": 0,
"status": "Active",
"autoDeleteOnIdle": "P10675199DT2H48M5.4775807S",
"enablePartitioning": true,
"enableExpress": false,
"createdAt": "2017-05-26T18:07:32.4592931Z",
"updatedAt": "2017-05-26T18:07:34.6243761Z",
"accessedAt": "0001-01-01T00:00:00Z"
}
}
定义
名称 | 说明 |
---|---|
created |
创建资源的标识类型。 |
Entity |
实体状态。 |
Error |
错误对象。 |
Error |
资源管理错误附加信息。 |
Error |
资源管理错误响应。 |
Message |
消息计数详细信息。 |
SBQueue |
队列资源的说明。 |
system |
与资源的创建和上次修改相关的元数据。 |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EntityStatus
实体状态。
名称 | 类型 | 说明 |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
ReceiveDisabled |
string |
|
Renaming |
string |
|
Restoring |
string |
|
SendDisabled |
string |
|
Unknown |
string |
Error
错误对象。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorResponse
资源管理错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
MessageCountDetails
消息计数详细信息。
名称 | 类型 | 说明 |
---|---|---|
activeMessageCount |
integer |
队列、主题或订阅中的活动消息数。 |
deadLetterMessageCount |
integer |
死信的消息数。 |
scheduledMessageCount |
integer |
计划的消息数。 |
transferDeadLetterMessageCount |
integer |
传输到死信的消息数。 |
transferMessageCount |
integer |
传输到其他队列、主题或订阅的消息数。 |
SBQueue
队列资源的说明。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
资源所在的地理位置 |
name |
string |
资源的名称 |
properties.accessedAt |
string |
上次发送消息的时间,或上次收到此队列的接收请求的时间。 |
properties.autoDeleteOnIdle |
string |
ISO 8061 timeSpan 空闲间隔后,队列将自动删除。 最短持续时间为 5 分钟。 |
properties.countDetails |
消息计数详细信息。 |
|
properties.createdAt |
string |
消息的确切创建时间。 |
properties.deadLetteringOnMessageExpiration |
boolean |
一个 值,该值指示消息过期时此队列是否支持死信。 |
properties.defaultMessageTimeToLive |
string |
ISO 8601 默认消息时间跨度到实时值。 这是消息过期的持续时间,从消息发送到服务总线时开始。 这是未在消息本身上设置 TimeToLive 时使用的默认值。 |
properties.duplicateDetectionHistoryTimeWindow |
string |
ISO 8601 timeSpan 结构,用于定义重复检测历史记录的持续时间。 默认值为 10 分钟。 |
properties.enableBatchedOperations |
boolean |
指示是否启用服务器端批处理操作的值。 |
properties.enableExpress |
boolean |
一个 值,该值指示是否启用 Express Entities。 在将消息写入持久存储之前,快速队列暂时将消息保留在内存中。 |
properties.enablePartitioning |
boolean |
一个 值,该值指示是否要跨多个消息代理对队列进行分区。 |
properties.forwardDeadLetteredMessagesTo |
string |
用于转发死信消息的队列/主题名称 |
properties.forwardTo |
string |
用于转发消息的队列/主题名称 |
properties.lockDuration |
string |
ISO 8601 速览锁的持续时间;也就是说,消息锁定给其他接收方的时间量。 LockDuration 的最大值为 5 分钟;默认值为 1 分钟。 |
properties.maxDeliveryCount |
integer |
最大传递计数。 传递次数达到此数字后,自动将消息视为死信。 默认值为 10。 |
properties.maxMessageSizeInKilobytes |
integer |
队列可接受的消息有效负载) 的最大大小 (KB。 此属性目前仅在高级版中使用,默认值为 1024。 |
properties.maxSizeInMegabytes |
integer |
队列的最大大小(以 MB 为单位),即为队列分配的内存大小。 默认值为 1024。 |
properties.messageCount |
integer |
队列中的消息数。 |
properties.requiresDuplicateDetection |
boolean |
一个值,该值指示此队列是否需要重复检测。 |
properties.requiresSession |
boolean |
一个 值,该值指示队列是否支持会话的概念。 |
properties.sizeInBytes |
integer |
队列的大小(以字节为单位)。 |
properties.status |
枚举消息实体状态的可能值。 |
|
properties.updatedAt |
string |
消息的确切更新时间。 |
systemData |
与此资源相关的系统元数据。 |
|
type |
string |
资源类型。 例如“Microsoft.EventHub/Namespaces”或“Microsoft.EventHub/Namespaces/EventHubs” |
systemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源的创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
上次修改资源的标识类型。 |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |