Queues - Get
Devolve uma descrição para a fila especificada.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues/{queueName}?api-version=2021-11-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
O nome do espaço de nomes |
queue
|
path | True |
string |
O nome da fila. |
resource
|
path | True |
string |
Nome do Grupo de recursos na subscrição do Azure. |
subscription
|
path | True |
string |
Credenciais de subscrição que identificam exclusivamente uma subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço. |
api-version
|
query | True |
string |
Versão da API de Cliente. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
A descrição da fila foi devolvida com êxito. |
|
Other Status Codes |
Resposta de erro do ServiceBus que descreve a razão pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
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"
}
}
Definições
Name | Description |
---|---|
created |
O tipo de identidade que criou o recurso. |
Entity |
Estado da entidade. |
Error |
O objeto de erro. |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
A resposta ao erro de gestão de recursos. |
Message |
Detalhes da Contagem de Mensagens. |
SBQueue |
Descrição do Recurso de fila. |
system |
Metadados relativos à criação e última modificação do recurso. |
createdByType
O tipo de identidade que criou o recurso.
Name | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EntityStatus
Estado da entidade.
Name | Tipo | Description |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
|
Disabled |
string |
|
ReceiveDisabled |
string |
|
Renaming |
string |
|
Restoring |
string |
|
SendDisabled |
string |
|
Unknown |
string |
Error
O objeto de erro.
Name | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorAdditionalInfo
Informações adicionais sobre o erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorResponse
A resposta ao erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
MessageCountDetails
Detalhes da Contagem de Mensagens.
Name | Tipo | Description |
---|---|---|
activeMessageCount |
integer |
Número de mensagens ativas na fila, tópico ou subscrição. |
deadLetterMessageCount |
integer |
Número de mensagens que não são enviadas. |
scheduledMessageCount |
integer |
Número de mensagens agendadas. |
transferDeadLetterMessageCount |
integer |
Número de mensagens transferidas para cartas não entregues. |
transferMessageCount |
integer |
Número de mensagens transferidas para outra fila, tópico ou subscrição. |
SBQueue
Descrição do Recurso de fila.
Name | Tipo | Description |
---|---|---|
id |
string |
ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
A localização geográfica onde o recurso se encontra |
name |
string |
O nome do recurso |
properties.accessedAt |
string |
A última vez que uma mensagem foi enviada ou a última vez que houve um pedido de receção para esta fila. |
properties.autoDeleteOnIdle |
string |
Intervalo de inatividade iso 8061 timeSpan após o qual a fila é eliminada automaticamente. A duração mínima é 5 minutos. |
properties.countDetails |
Detalhes da Contagem de Mensagens. |
|
properties.createdAt |
string |
A hora exata em que a mensagem foi criada. |
properties.deadLetteringOnMessageExpiration |
boolean |
Um valor que indica se esta fila tem suporte de letra inativa quando uma mensagem expira. |
properties.defaultMessageTimeToLive |
string |
IsO 8601 período de tempo de mensagem predefinido para valor dinâmico. Esta é a duração após a qual a mensagem expira, a partir do momento em que a mensagem é enviada para o Service Bus. Este é o valor predefinido utilizado quando TimeToLive não está definido numa mensagem propriamente dita. |
properties.duplicateDetectionHistoryTimeWindow |
string |
ISO 8601 timeSpan structure that define a duração do histórico de deteção duplicado. O valor predefinido é 10 minutos. |
properties.enableBatchedOperations |
boolean |
Valor que indica se as operações em lote do lado do servidor estão ativadas. |
properties.enableExpress |
boolean |
Um valor que indica se as Entidades Express estão ativadas. Uma fila rápida contém temporariamente uma mensagem na memória antes de a escrever no armazenamento persistente. |
properties.enablePartitioning |
boolean |
Um valor que indica se a fila deve ser particionada em vários mediadores de mensagens. |
properties.forwardDeadLetteredMessagesTo |
string |
Nome da fila/tópico para reencaminhar a mensagem Carta Morta |
properties.forwardTo |
string |
Nome da fila/tópico para reencaminhar as mensagens |
properties.lockDuration |
string |
ISO 8601 duração do intervalo de tempo de um bloqueio de pré-visualização; ou seja, a quantidade de tempo que a mensagem está bloqueada para outros recetores. O valor máximo para LockDuration é de 5 minutos; o valor predefinido é 1 minuto. |
properties.maxDeliveryCount |
integer |
A contagem máxima de entrega. Uma mensagem é automaticamente inativa após este número de entregas. o valor predefinido é 10. |
properties.maxMessageSizeInKilobytes |
integer |
Tamanho máximo (em KB) do payload da mensagem que pode ser aceite pela fila. Esta propriedade só é utilizada hoje em dia no Premium e a predefinição é 1024. |
properties.maxSizeInMegabytes |
integer |
O tamanho máximo da fila em megabytes, que é o tamanho da memória alocada para a fila. A predefinição é 1024. |
properties.messageCount |
integer |
O número de mensagens na fila. |
properties.requiresDuplicateDetection |
boolean |
Um valor que indica se esta fila requer deteção duplicada. |
properties.requiresSession |
boolean |
Um valor que indica se a fila suporta o conceito de sessões. |
properties.sizeInBytes |
integer |
O tamanho da fila, em bytes. |
properties.status |
Enumera os valores possíveis para o estado de uma entidade de mensagens. |
|
properties.updatedAt |
string |
A hora exata em que a mensagem foi atualizada. |
systemData |
Os metadados do sistema relacionados com este recurso. |
|
type |
string |
O tipo de recurso. Por exemplo, "Microsoft.EventHub/Namespaces" ou "Microsoft.EventHub/Namespaces/EventHubs" |
systemData
Metadados relativos à criação e última modificação do recurso.
Name | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O tipo de identidade que modificou o recurso pela última vez. |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |