您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Prefixes - Get

获取给定订阅、资源组和对等互连服务下具有指定名称的现有前缀。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Peering/peeringServices/{peeringServiceName}/prefixes/{prefixName}?api-version=2021-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Peering/peeringServices/{peeringServiceName}/prefixes/{prefixName}?$expand={$expand}&api-version=2021-01-01

URI 参数

Name In Required Type Description
peeringServiceName
path True
  • string

对等互连服务的名称。

prefixName
path True
  • string

前缀的名称。

resourceGroupName
path True
  • string

资源组的名称。

subscriptionId
path True
  • string

Azure 订阅 ID。

api-version
query True
  • string

客户端 API 版本。

$expand
query
  • string

要展开的属性。

响应

Name Type Description
200 OK

确定

Other Status Codes

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

安全性

azure_auth

Azure Active DirectoryOAuth2 Flow。

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

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

Get a prefix associated with the peering service

Sample Request

GET https://management.azure.com/subscriptions/subId/resourceGroups/rgName/providers/Microsoft.Peering/peeringServices/peeringServiceName/prefixes/peeringServicePrefixName?api-version=2021-01-01

Sample Response

{
  "properties": {
    "prefix": "192.168.1.0/24",
    "prefixValidationState": "Verified",
    "learnedType": "ViaServiceProvider",
    "peeringServicePrefixKey": "00000000-0000-0000-0000-000000000000",
    "provisioningState": "Succeeded"
  },
  "name": "peeringServicePrefixName",
  "id": "/subscriptions/subId/resourceGroups/rgName/providers/Microsoft.Peering/peeringServices/peeringServiceName/prefixes/peeringServicePrefixName"
}

定义

ErrorDetail

描述操作失败原因的错误详细信息。

ErrorResponse

错误响应,指示操作失败的原因。

learnedType

前缀学习类型

PeeringServicePrefix

对等互连服务前缀类。

PeeringServicePrefixEvent

与前缀关联的事件的详细信息。

prefixValidationState

前缀验证状态。

provisioningState

资源的预配状态。

ErrorDetail

描述操作失败原因的错误详细信息。

Name Type Description
code
  • string

错误代码。

message
  • string

错误消息。

ErrorResponse

错误响应,指示操作失败的原因。

Name Type Description
error

描述操作失败原因的错误详细信息。

learnedType

前缀学习类型

Name Type Description
None
  • string
ViaServiceProvider
  • string
ViaSession
  • string

PeeringServicePrefix

对等互连服务前缀类。

Name Type Description
id
  • string

资源的 ID。

name
  • string

资源的名称。

properties.errorMessage
  • string

验证状态错误消息

properties.events

对等互连服务前缀的事件列表

properties.learnedType

前缀学习类型

properties.peeringServicePrefixKey
  • string

对等互连服务前缀密钥

properties.prefix
  • string

流量的来源前缀。

properties.prefixValidationState

前缀验证状态

properties.provisioningState

资源的预配状态。

type
  • string

资源类型。

PeeringServicePrefixEvent

与前缀关联的事件的详细信息。

Name Type Description
eventDescription
  • string

与前缀关联的事件的说明。

eventLevel
  • string

与前缀关联的事件的级别。

eventSummary
  • string

与前缀关联的事件的摘要。

eventTimestamp
  • string

与前缀关联的事件的时间戳。

eventType
  • string

与前缀关联的事件的类型。

prefixValidationState

前缀验证状态。

Name Type Description
Failed
  • string
Invalid
  • string
None
  • string
Pending
  • string
Unknown
  • string
Verified
  • string
Warning
  • string

provisioningState

资源的预配状态。

Name Type Description
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string