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

Namespaces - Create Or Update

创建 Azure 中继命名空间。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Relay/namespaces/{namespaceName}?api-version=2017-04-01

URI 参数

Name In Required Type Description
namespaceName
path True
  • string

命名空间名称

resourceGroupName
path True
  • string

Azure 订阅中的资源组的名称。

subscriptionId
path True
  • string

唯一标识Microsoft Azure订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

api-version
query True
  • string

客户端 API 版本。

请求正文

Name Required Type Description
location True
  • string

资源位置。

sku

命名空间的 SKU。

tags
  • object

资源标记。

响应

Name Type Description
200 OK

命名空间创建请求成功。

201 Created

命名空间创建请求已接受。

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 模拟用户帐户

示例

RelayNamespaceCreate

Sample Request

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/resourcegroup/providers/Microsoft.Relay/namespaces/example-RelayNamespace-01?api-version=2017-04-01

{
  "sku": {
    "name": "Standard",
    "tier": "Standard"
  },
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  }
}

Sample Response

{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/resourcegroup/providers/Microsoft.Relay/namespaces/example-RelayNamespace-01",
  "name": "example-RelayNamespace-01",
  "type": "Microsoft.Relay/Namespaces",
  "location": "West US",
  "sku": {
    "name": "Standard",
    "tier": "Standard"
  },
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "provisioningState": "Unknown",
    "metricId": "ffffffff-ffff-ffff-ffff-ffffffffffff:example-Relaynamespace-01"
  }
}
{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/resourcegroup/providers/Microsoft.Relay/namespaces/example-RelayNamespace-01",
  "name": "example-RelayNamespace-01",
  "type": "Microsoft.Relay/Namespaces",
  "location": "West US",
  "sku": {
    "name": "Standard",
    "tier": "Standard"
  },
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "provisioningState": "Unknown",
    "metricId": "ffffffff-ffff-ffff-ffff-ffffffffffff:example-Relaynamespace-01"
  }
}

定义

ErrorResponse

错误响应指示中继服务无法处理传入请求。 错误消息中提供了原因。

provisioningStateEnum
RelayNamespace

命名空间资源的说明。

Sku

命名空间的 SKU。

SkuName

此 SKU 的名称。

SkuTier

此 SKU 的层。

ErrorResponse

错误响应指示中继服务无法处理传入请求。 错误消息中提供了原因。

Name Type Description
code
  • string

错误代码。

message
  • string

指示操作失败的原因的错误消息。

provisioningStateEnum

Name Type Description
Created
  • string
Deleted
  • string
Failed
  • string
Succeeded
  • string
Unknown
  • string
Updating
  • string

RelayNamespace

命名空间资源的说明。

Name Type Description
id
  • string

资源 ID。

location
  • string

资源位置。

name
  • string

资源名称。

properties.createdAt
  • string

创建命名空间的时间。

properties.metricId
  • string

Azure Insights指标的标识符。

properties.provisioningState
properties.serviceBusEndpoint
  • string

可用于执行服务总线操作的终结点。

properties.updatedAt
  • string

命名空间更新的时间。

sku

命名空间的 SKU。

tags
  • object

资源标记。

type
  • string

资源类型。

Sku

命名空间的 SKU。

Name Type Description
name

此 SKU 的名称。

tier

此 SKU 的层。

SkuName

此 SKU 的名称。

Name Type Description
Standard
  • string

SkuTier

此 SKU 的层。

Name Type Description
Standard
  • string