你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Queue - Create

使用指定的队列名称在指定帐户下创建一个新队列。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/queueServices/default/queues/{queueName}?api-version=2021-09-01

URI 参数

Name In Required Type Description
accountName
path True
  • string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符,并且只能使用数字和小写字母。

queueName
path True
  • string

队列名称在存储帐户中必须唯一,并且必须介于 3 到 63 个字符之间。名称必须包含小写字母数字和短划线 () 字符,它应以字母数字字符开头和结尾,并且不能有两个连续短划线 (-) 字符。

Regex pattern: ^[a-z0-9]([a-z0-9]|(-(?!-))){1,61}[a-z0-9]$

resourceGroupName
path True
  • string

用户订阅中的资源组的名称。 此名称不区分大小写。

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True
  • string

目标订阅的 ID。

api-version
query True
  • string

要用于此操作的 API 版本。

请求正文

Name Type Description
properties.metadata
  • object

表示队列元数据的名称值配对。

响应

Name Type Description
200 OK

确定 - 成功创建具有给定队列名称的队列。

Other Status Codes

描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

QueueOperationPut
QueueOperationPutWithMetadata

QueueOperationPut

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/queueServices/default/queues/queue6185?api-version=2021-09-01

{}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/queueServices/default/queues/queue6185",
  "name": "queue6185",
  "type": "Microsoft.Storage/storageAccounts/queueServices/queues"
}

QueueOperationPutWithMetadata

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/queueServices/default/queues/queue6185?api-version=2021-09-01

{
  "properties": {
    "metadata": {
      "sample1": "meta1",
      "sample2": "meta2"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/queueServices/default/queues/queue6185",
  "name": "queue6185",
  "type": "Microsoft.Storage/storageAccounts/queueServices/queues",
  "properties": {
    "metadata": {
      "sample1": "meta1",
      "sample2": "meta2"
    }
  }
}

定义

CloudError

存储服务的错误响应。

CloudErrorBody

存储服务的错误响应。

StorageQueue

CloudError

存储服务的错误响应。

Name Type Description
error

存储服务的错误响应。

CloudErrorBody

存储服务的错误响应。

Name Type Description
code
  • string

错误的标识符。 代码是固定的,旨在以编程方式使用。

details

有关错误的其他详细信息的列表。

message
  • string

描述错误的消息,旨在适合在用户界面中显示。

target
  • string

特定错误的目标。 例如,错误属性的名称。

StorageQueue

Name Type Description
id
  • string

资源的完全限定的资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

资源的名称

properties.approximateMessageCount
  • integer

指示队列中消息的近似数目的整数。 此数字不低于队列中的实际消息数,但可能会更高。

properties.metadata
  • object

表示队列元数据的名称值配对。

type
  • string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft”。存储/storageAccounts”