Queues - Get
Retourneert een beschrijving voor de opgegeven wachtrij.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues/{queueName}?api-version=2021-11-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
De naam van de naamruimte |
queue
|
path | True |
string |
De naam van de wachtrij. |
resource
|
path | True |
string |
Naam van de resourcegroep binnen het Azure-abonnement. |
subscription
|
path | True |
string |
Abonnementsreferenties waarmee een Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep. |
api-version
|
query | True |
string |
Client-API-versie. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
De beschrijving van de wachtrij is geretourneerd. |
|
Other Status Codes |
ServiceBus-foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
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"
}
}
Definities
Name | Description |
---|---|
created |
Het type identiteit waarmee de resource is gemaakt. |
Entity |
Entiteitsstatus. |
Error |
Het foutobject. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
Het foutantwoord voor resourcebeheer. |
Message |
Details van het aantal berichten. |
SBQueue |
Beschrijving van wachtrijresource. |
system |
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource. |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EntityStatus
Entiteitsstatus.
Name | Type | Description |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
ReceiveDisabled |
string |
|
Renaming |
string |
|
Restoring |
string |
|
SendDisabled |
string |
|
Unknown |
string |
Error
Het foutobject.
Name | Type | Description |
---|---|---|
additionalInfo |
De fout aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het type aanvullende informatie. |
ErrorResponse
Het foutantwoord voor resourcebeheer.
Name | Type | Description |
---|---|---|
error |
Het foutobject. |
MessageCountDetails
Details van het aantal berichten.
Name | Type | Description |
---|---|---|
activeMessageCount |
integer |
Aantal actieve berichten in de wachtrij, het onderwerp of het abonnement. |
deadLetterMessageCount |
integer |
Aantal berichten met een onbestelbare brief. |
scheduledMessageCount |
integer |
Aantal geplande berichten. |
transferDeadLetterMessageCount |
integer |
Het aantal berichten dat is overgebracht naar onbestelbare letters. |
transferMessageCount |
integer |
Het aantal berichten dat is overgebracht naar een andere wachtrij, onderwerp of abonnement. |
SBQueue
Beschrijving van wachtrijresource.
Name | Type | Description |
---|---|---|
id |
string |
Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
De geografische locatie waar de resource zich bevindt |
name |
string |
De naam van de resource |
properties.accessedAt |
string |
De laatste keer dat een bericht is verzonden of de laatste keer dat er een ontvangstaanvraag voor deze wachtrij is ingediend. |
properties.autoDeleteOnIdle |
string |
ISO 8061 timeSpan inactief interval waarna de wachtrij automatisch wordt verwijderd. De minimale duur is vijf minuten. |
properties.countDetails |
Details van het aantal berichten. |
|
properties.createdAt |
string |
De exacte tijd waarop het bericht is gemaakt. |
properties.deadLetteringOnMessageExpiration |
boolean |
Een waarde die aangeeft of deze wachtrij ondersteuning voor onbestelbare berichten heeft wanneer een bericht verloopt. |
properties.defaultMessageTimeToLive |
string |
Iso 8601 standaard bericht timespan to live waarde. Dit is de duur waarna het bericht verloopt, te beginnen vanaf het moment dat het bericht naar Service Bus wordt verzonden. Dit is de standaardwaarde die wordt gebruikt wanneer TimeToLive niet is ingesteld voor een bericht zelf. |
properties.duplicateDetectionHistoryTimeWindow |
string |
ISO 8601 timeSpan-structuur die de duur van de geschiedenis van de dubbele detectie definieert. De standaardwaarde is 10 minuten. |
properties.enableBatchedOperations |
boolean |
Waarde die aangeeft of batchbewerkingen aan de serverzijde zijn ingeschakeld. |
properties.enableExpress |
boolean |
Een waarde die aangeeft of Express-entiteiten zijn ingeschakeld. Een snelle wachtrij bevat een bericht tijdelijk in het geheugen voordat het naar permanente opslag wordt geschreven. |
properties.enablePartitioning |
boolean |
Een waarde die aangeeft of de wachtrij moet worden gepartitioneerd over meerdere berichtbrokers. |
properties.forwardDeadLetteredMessagesTo |
string |
Wachtrij-/onderwerpnaam voor het doorsturen van het onbestelbare bericht |
properties.forwardTo |
string |
Wachtrij-/onderwerpnaam voor het doorsturen van de berichten |
properties.lockDuration |
string |
ISO 8601 tijdsduur van een peek-lock; dat wil gezegd, de hoeveelheid tijd dat het bericht is vergrendeld voor andere ontvangers. De maximumwaarde voor LockDuration is 5 minuten; de standaardwaarde is 1 minuut. |
properties.maxDeliveryCount |
integer |
Het maximale aantal leveringen. Een bericht wordt na dit aantal leveringen automatisch in een impasse gezet. de standaardwaarde is 10. |
properties.maxMessageSizeInKilobytes |
integer |
Maximale grootte (in kB) van de nettolading van het bericht die kan worden geaccepteerd door de wachtrij. Deze eigenschap wordt momenteel alleen gebruikt in Premium en de standaardwaarde is 1024. |
properties.maxSizeInMegabytes |
integer |
De maximale grootte van de wachtrij in megabytes. Dit is de grootte van het geheugen dat voor de wachtrij is toegewezen. De standaardwaarde is 1024. |
properties.messageCount |
integer |
Het aantal berichten in de wachtrij. |
properties.requiresDuplicateDetection |
boolean |
Een waarde die aangeeft of voor deze wachtrij dubbele detectie is vereist. |
properties.requiresSession |
boolean |
Een waarde die aangeeft of de wachtrij het concept van sessies ondersteunt. |
properties.sizeInBytes |
integer |
De grootte van de wachtrij, in bytes. |
properties.status |
Inventariseert de mogelijke waarden voor de status van een berichtenentiteit. |
|
properties.updatedAt |
string |
De exacte tijd waarop het bericht is bijgewerkt. |
systemData |
De systeemmetagegevens met betrekking tot deze resource. |
|
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.EventHub/Namespaces' of 'Microsoft.EventHub/Namespaces/EventHubs' |
systemData
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
De tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit die de resource heeft gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string |
Het type identiteit dat de resource het laatst heeft gewijzigd. |
lastModifiedBy |
string |
De identiteit die de resource het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource het laatst heeft gewijzigd. |