Prefixes - Create Or Update

참조

Service:: Peering

API Version:: 2021-01-01

지정된 구독, 리소스 그룹 및 피어링 서비스 아래에 지정된 이름의 새 접두사를 만듭니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	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 버전입니다.

요청 본문

Name	형식	Description
properties.peeringServicePrefixKey	string	피어링 서비스 접두사 키
properties.prefix	string	트래픽이 시작되는 접두사입니다.

응답

Name	형식	Description
200 OK	PeeringServicePrefix	정상
201 Created	PeeringServicePrefix	생성일
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

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	사용자 계정 가장

예제

Create or update a prefix for the peering service

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

{
  "properties": {
    "prefix": "192.168.1.0/24",
    "peeringServicePrefixKey": "00000000-0000-0000-0000-000000000000"
  }
}

/** Samples for Prefixes CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/peering/resource-manager/Microsoft.Peering/stable/2021-01-01/examples/CreatePeeringServicePrefix.json
     */
    /**
     * Sample code: Create or update a prefix for the peering service.
     *
     * @param manager Entry point to PeeringManager.
     */
    public static void createOrUpdateAPrefixForThePeeringService(
        com.azure.resourcemanager.peering.PeeringManager manager) {
        manager
            .prefixes()
            .define("peeringServicePrefixName")
            .withExistingPeeringService("rgName", "peeringServiceName")
            .withPrefix("192.168.1.0/24")
            .withPeeringServicePrefixKey("00000000-0000-0000-0000-000000000000")
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "properties": {
    "prefix": "192.168.1.0/24",
    "prefixValidationState": "Failed",
    "learnedType": "None",
    "errorMessage": "Prefix is not announced by the service provider to Microsoft.",
    "peeringServicePrefixKey": "00000000-0000-0000-0000-000000000000",
    "provisioningState": "Succeeded"
  },
  "name": "peeringServicePrefixName",
  "id": "/subscriptions/subId/resourceGroups/rgName/providers/Microsoft.Peering/peeringServices/peeringServiceName/prefixes/peeringServicePrefixName"
}

Status code:: 201

{
  "properties": {
    "prefix": "192.168.1.0/24",
    "prefixValidationState": "Failed",
    "learnedType": "None",
    "errorMessage": "Prefix is not announced by the service provider to Microsoft.",
    "peeringServicePrefixKey": "00000000-0000-0000-0000-000000000000",
    "provisioningState": "Succeeded"
  },
  "name": "peeringServicePrefixName",
  "id": "/subscriptions/subId/resourceGroups/rgName/providers/Microsoft.Peering/peeringServices/peeringServiceName/prefixes/peeringServicePrefixName"
}

정의

Name	Description
ErrorDetail	작업이 실패한 이유를 설명하는 오류 세부 정보입니다.
ErrorResponse	작업이 실패한 이유를 나타내는 오류 응답입니다.
learnedType	학습된 접두사 형식
PeeringServicePrefix	피어링 서비스 접두사 클래스입니다.
PeeringServicePrefixEvent	접두사와 연결된 이벤트의 세부 정보입니다.
prefixValidationState	접두사 유효성 검사 상태입니다.
provisioningState	리소스의 프로비전 상태입니다.

ErrorDetail

작업이 실패한 이유를 설명하는 오류 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.

ErrorResponse

작업이 실패한 이유를 나타내는 오류 응답입니다.

Name	형식	Description
error	ErrorDetail	작업이 실패한 이유를 설명하는 오류 세부 정보입니다.

learnedType

학습된 접두사 형식

Name	형식	Description
None	string
ViaServiceProvider	string
ViaSession	string

PeeringServicePrefix

피어링 서비스 접두사 클래스입니다.

Name	형식	Description
id	string	리소스의 ID입니다.
name	string	리소스의 이름입니다.
properties.errorMessage	string	유효성 검사 상태에 대한 오류 메시지
properties.events	PeeringServicePrefixEvent[]	피어링 서비스 접두사에 대한 이벤트 목록
properties.learnedType	learnedType	학습된 접두사 형식
properties.peeringServicePrefixKey	string	피어링 서비스 접두사 키
properties.prefix	string	트래픽이 시작되는 접두사입니다.
properties.prefixValidationState	prefixValidationState	접두사 유효성 검사 상태
properties.provisioningState	provisioningState	리소스의 프로비전 상태입니다.
type	string	리소스 형식입니다.

PeeringServicePrefixEvent

접두사와 연결된 이벤트의 세부 정보입니다.

Name	형식	Description
eventDescription	string	접두사와 연결된 이벤트에 대한 설명입니다.
eventLevel	string	접두사에 연결된 이벤트의 수준입니다.
eventSummary	string	접두사와 연결된 이벤트의 요약입니다.
eventTimestamp	string	접두사에 연결된 이벤트의 타임스탬프입니다.
eventType	string	접두사에 연결된 이벤트의 형식입니다.

prefixValidationState

접두사 유효성 검사 상태입니다.

Name	형식	Description
Failed	string
Invalid	string
None	string
Pending	string
Unknown	string
Verified	string
Warning	string

provisioningState

리소스의 프로비전 상태입니다.

Name	형식	Description
Deleting	string
Failed	string
Succeeded	string
Updating	string