Prefixes - Create Or Update

Referência

Service:: Peering

API Version:: 2021-01-01

Cria um novo prefixo com o nome especificado na subscrição, grupo de recursos e serviço de peering especificado.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
peeringServiceName	path	True	string	O nome do serviço de peering.
prefixName	path	True	string	O nome do prefixo.
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string	O ID da subscrição do Azure.
api-version	query	True	string	A versão da API de cliente.

Corpo do Pedido

Name	Tipo	Description
properties.peeringServicePrefixKey	string	A chave de prefixo do serviço de peering
properties.prefix	string	O prefixo a partir do qual o tráfego é originado.

Respostas

Name	Tipo	Description
200 OK	PeeringServicePrefix	OK
201 Created	PeeringServicePrefix	Criado
Other Status Codes	ErrorResponse	Resposta de erro 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

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"
}

Definições

Name	Description
ErrorDetail	O detalhe do erro que descreve o motivo pelo qual uma operação falhou.
ErrorResponse	A resposta de erro que indica a razão pela qual uma operação falhou.
learnedType	O tipo de prefixo aprendido
PeeringServicePrefix	A classe de prefixo do serviço de peering.
PeeringServicePrefixEvent	Os detalhes do evento associado a um prefixo.
prefixValidationState	O estado de validação do prefixo.
provisioningState	O estado de aprovisionamento do recurso.

ErrorDetail

O detalhe do erro que descreve o motivo pelo qual uma operação falhou.

Name	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.

ErrorResponse

A resposta de erro que indica a razão pela qual uma operação falhou.

Name	Tipo	Description
error	ErrorDetail	O detalhe do erro que descreve o motivo pelo qual uma operação falhou.

learnedType

O tipo de prefixo aprendido

Name	Tipo	Description
None	string
ViaServiceProvider	string
ViaSession	string

PeeringServicePrefix

A classe de prefixo do serviço de peering.

Name	Tipo	Description
id	string	O ID do recurso.
name	string	O nome do recurso.
properties.errorMessage	string	A mensagem de erro para o estado de validação
properties.events	PeeringServicePrefixEvent[]	A lista de eventos para o prefixo do serviço de peering
properties.learnedType	learnedType	O tipo de prefixo aprendido
properties.peeringServicePrefixKey	string	A chave de prefixo do serviço de peering
properties.prefix	string	O prefixo a partir do qual o tráfego é originado.
properties.prefixValidationState	prefixValidationState	O estado de validação do prefixo
properties.provisioningState	provisioningState	O estado de aprovisionamento do recurso.
type	string	O tipo de recurso.

PeeringServicePrefixEvent

Os detalhes do evento associado a um prefixo.

Name	Tipo	Description
eventDescription	string	A descrição do evento associado a um prefixo.
eventLevel	string	O nível do evento associado a um prefixo.
eventSummary	string	O resumo do evento associado a um prefixo.
eventTimestamp	string	O carimbo de data/hora do evento associado a um prefixo.
eventType	string	O tipo de evento associado a um prefixo.

prefixValidationState

O estado de validação do prefixo.

Name	Tipo	Description
Failed	string
Invalid	string
None	string
Pending	string
Unknown	string
Verified	string
Warning	string

provisioningState

O estado de aprovisionamento do recurso.

Name	Tipo	Description
Deleting	string
Failed	string
Succeeded	string
Updating	string