Express Route Cross Connections - Create Or Update

Служба:

ExpressRoute

Версия API:

2023-11-01

Обновите указанный ExpressRouteCrossConnection.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCrossConnections/{crossConnectionName}?api-version=2023-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
crossConnectionName	path	True	string	Имя ExpressRouteCrossConnection.
resourceGroupName	path	True	string	Имя группы ресурсов.
subscriptionId	path	True	string	Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.
api-version	query	True	string	Версия КЛИЕНТСКОго API.

Текст запроса

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
properties.expressRouteCircuit	ExpressRouteCircuitReference	The ExpressRouteCircuit.
properties.peerings	ExpressRouteCrossConnectionPeering[]	Список пирингов.
properties.serviceProviderNotes	string	Дополнительные заметки только для чтения, заданные поставщиком подключений.
properties.serviceProviderProvisioningState	ServiceProviderProvisioningState	Состояние подготовки канала в системе поставщика подключений.
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	ExpressRouteCrossConnection	Обновите успешно. Операция возвращает полученный ресурс ExpressRouteCrossConnection.
Other Status Codes	CloudError	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

UpdateExpressRouteCrossConnection

Образец запроса

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/CrossConnection-SiliconValley/providers/Microsoft.Network/expressRouteCrossConnections/<circuitServiceKey>?api-version=2023-11-01

{
  "properties": {
    "serviceProviderProvisioningState": "NotProvisioned"
  }
}

Java

import com.azure.resourcemanager.network.fluent.models.ExpressRouteCrossConnectionInner;
import com.azure.resourcemanager.network.models.ServiceProviderProvisioningState;

/**
 * Samples for ExpressRouteCrossConnections CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-11-01/examples/
     * ExpressRouteCrossConnectionUpdate.json
     */
    /**
     * Sample code: UpdateExpressRouteCrossConnection.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateExpressRouteCrossConnection(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.networks().manager().serviceClient().getExpressRouteCrossConnections().createOrUpdate(
            "CrossConnection-SiliconValley", "<circuitServiceKey>", new ExpressRouteCrossConnectionInner()
                .withServiceProviderProvisioningState(ServiceProviderProvisioningState.NOT_PROVISIONED),
            com.azure.core.util.Context.NONE);
    }
}

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

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.network import NetworkManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-network
# USAGE
    python express_route_cross_connection_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = NetworkManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.express_route_cross_connections.begin_create_or_update(
        resource_group_name="CrossConnection-SiliconValley",
        cross_connection_name="<circuitServiceKey>",
        parameters={"properties": {"serviceProviderProvisioningState": "NotProvisioned"}},
    ).result()
    print(response)


# x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-11-01/examples/ExpressRouteCrossConnectionUpdate.json
if __name__ == "__main__":
    main()

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

Go

package armnetwork_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/f4c6c8697c59f966db0d1e36b62df3af3bca9065/specification/network/resource-manager/Microsoft.Network/stable/2023-11-01/examples/ExpressRouteCrossConnectionUpdate.json
func ExampleExpressRouteCrossConnectionsClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armnetwork.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewExpressRouteCrossConnectionsClient().BeginCreateOrUpdate(ctx, "CrossConnection-SiliconValley", "<circuitServiceKey>", armnetwork.ExpressRouteCrossConnection{
		Properties: &armnetwork.ExpressRouteCrossConnectionProperties{
			ServiceProviderProvisioningState: to.Ptr(armnetwork.ServiceProviderProvisioningStateNotProvisioned),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ExpressRouteCrossConnection = armnetwork.ExpressRouteCrossConnection{
	// 	Name: to.Ptr("<circuitServiceKey>"),
	// 	Type: to.Ptr("Microsoft.Network/expressRouteCrossConnections"),
	// 	ID: to.Ptr("/subscriptions/subid/resourceGroups/CrossConnectionSiliconValley/providers/Microsoft.Network/expressRouteCrossConnections/<circuitServiceKey>"),
	// 	Location: to.Ptr("brazilsouth"),
	// 	Properties: &armnetwork.ExpressRouteCrossConnectionProperties{
	// 		BandwidthInMbps: to.Ptr[int32](1000),
	// 		ExpressRouteCircuit: &armnetwork.ExpressRouteCircuitReference{
	// 			ID: to.Ptr("/subscriptions/subid/resourceGroups/ertest/providers/Microsoft.Network/expressRouteCircuits/er1"),
	// 		},
	// 		PeeringLocation: to.Ptr("SiliconValley"),
	// 		Peerings: []*armnetwork.ExpressRouteCrossConnectionPeering{
	// 		},
	// 		PrimaryAzurePort: to.Ptr("bvtazureixp01"),
	// 		ProvisioningState: to.Ptr(armnetwork.ProvisioningStateSucceeded),
	// 		STag: to.Ptr[int32](2),
	// 		SecondaryAzurePort: to.Ptr("bvtazureixp01"),
	// 		ServiceProviderProvisioningState: to.Ptr(armnetwork.ServiceProviderProvisioningStateNotProvisioned),
	// 	},
	// }
}

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

JavaScript

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Update the specified ExpressRouteCrossConnection.
 *
 * @summary Update the specified ExpressRouteCrossConnection.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-11-01/examples/ExpressRouteCrossConnectionUpdate.json
 */
async function updateExpressRouteCrossConnection() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName =
    process.env["NETWORK_RESOURCE_GROUP"] || "CrossConnection-SiliconValley";
  const crossConnectionName = "<circuitServiceKey>";
  const parameters = {
    serviceProviderProvisioningState: "NotProvisioned",
  };
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.expressRouteCrossConnections.beginCreateOrUpdateAndWait(
    resourceGroupName,
    crossConnectionName,
    parameters,
  );
  console.log(result);
}

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

Пример ответа

Код состояния:

200

{
  "name": "<circuitServiceKey>",
  "id": "/subscriptions/subid/resourceGroups/CrossConnectionSiliconValley/providers/Microsoft.Network/expressRouteCrossConnections/<circuitServiceKey>",
  "type": "Microsoft.Network/expressRouteCrossConnections",
  "location": "brazilsouth",
  "properties": {
    "provisioningState": "Enabled",
    "expressRouteCircuit": {
      "id": "/subscriptions/subid/resourceGroups/ertest/providers/Microsoft.Network/expressRouteCircuits/er1"
    },
    "peerings": [],
    "peeringLocation": "SiliconValley",
    "bandwidthInMbps": 1000,
    "primaryAzurePort": "bvtazureixp01",
    "secondaryAzurePort": "bvtazureixp01",
    "sTag": 2,
    "serviceProviderProvisioningState": "NotProvisioned"
  }
}

Определения

Имя	Описание
CloudError	Ответ на ошибку службы.
CloudErrorBody	Ответ на ошибку службы.
ExpressRouteCircuitPeeringAdvertisedPublicPrefixState	Объявленное состояние общедоступного префикса ресурса пиринга.
ExpressRouteCircuitPeeringConfig	Указывает конфигурацию пиринга.
ExpressRouteCircuitPeeringState	Состояние пиринга.
ExpressRouteCircuitReference	Ссылка на канал express route.
ExpressRouteCrossConnection	Ресурс ExpressRouteCrossConnection.
ExpressRouteCrossConnectionPeering	Пиринг в ресурсе ExpressRoute Cross Connection.
ExpressRoutePeeringState	Состояние пиринга.
ExpressRoutePeeringType	Тип пиринга.
Ipv6ExpressRouteCircuitPeeringConfig	Содержит конфигурацию пиринга IPv6.
ProvisioningState	Текущее состояние подготовки.
ServiceProviderProvisioningState	Состояние ServiceProviderProvisioningState ресурса.
SubResource	Ссылка на другой подресурс.

CloudError

Ответ на ошибку службы.

Имя	Тип	Описание
error	CloudErrorBody	Текст ошибки облака.

CloudErrorBody

Ответ на ошибку службы.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
details	CloudErrorBody[]	Список дополнительных сведений об ошибке.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target	string	Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

Объявленное состояние общедоступного префикса ресурса пиринга.

Имя	Тип	Описание
Configured	string
Configuring	string
NotConfigured	string
ValidationNeeded	string

ExpressRouteCircuitPeeringConfig

Указывает конфигурацию пиринга.

Имя	Тип	Описание
advertisedCommunities	string[]	Сообщества пиринга bgp. Указан для пиринга Майкрософт.
advertisedPublicPrefixes	string[]	Ссылка на ОбъявленияPublicPrefixes.
advertisedPublicPrefixesState	ExpressRouteCircuitPeeringAdvertisedPublicPrefixState	Объявленное состояние общедоступного префикса ресурса пиринга.
customerASN	integer	CustomerASN пиринга.
legacyMode	integer	Устаревший режим пиринга.
routingRegistryName	string	Значение RoutingRegistryName конфигурации.

ExpressRouteCircuitPeeringState

Состояние пиринга.

Имя	Тип	Описание
Disabled	string
Enabled	string

ExpressRouteCircuitReference

Ссылка на канал express route.

Имя	Тип	Описание
id	string	Соответствующий идентификатор канала Express Route.

ExpressRouteCrossConnection

Ресурс ExpressRouteCrossConnection.

Имя	Тип	Описание
etag	string	Уникальная строка только для чтения, которая изменяется при обновлении ресурса.
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.bandwidthInMbps	integer	Пропускная способность канала в Мбит/с.
properties.expressRouteCircuit	ExpressRouteCircuitReference	The ExpressRouteCircuit.
properties.peeringLocation	string	Расположение пиринга канала ExpressRoute.
properties.peerings	ExpressRouteCrossConnectionPeering[]	Список пирингов.
properties.primaryAzurePort	string	Имя основного порта.
properties.provisioningState	ProvisioningState	Состояние подготовки ресурса перекрестного подключения express route.
properties.sTag	integer	Идентификатор трафика канала.
properties.secondaryAzurePort	string	Имя дополнительного порта.
properties.serviceProviderNotes	string	Дополнительные заметки только для чтения, заданные поставщиком подключений.
properties.serviceProviderProvisioningState	ServiceProviderProvisioningState	Состояние подготовки канала в системе поставщика подключений.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

ExpressRouteCrossConnectionPeering

Пиринг в ресурсе ExpressRoute Cross Connection.

Имя	Тип	Описание
etag	string	Уникальная строка только для чтения, которая изменяется при обновлении ресурса.
id	string	Идентификатор ресурса.
name	string	Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу.
properties.azureASN	integer	The Azure ASN.
properties.gatewayManagerEtag	string	Etag GatewayManager.
properties.ipv6PeeringConfig	Ipv6ExpressRouteCircuitPeeringConfig	Конфигурация пиринга IPv6.
properties.lastModifiedBy	string	Кто был последним, чтобы изменить пиринг.
properties.microsoftPeeringConfig	ExpressRouteCircuitPeeringConfig	Конфигурация пиринга Майкрософт.
properties.peerASN	integer	Одноранговый ASN.
properties.peeringType	ExpressRoutePeeringType	Тип пиринга.
properties.primaryAzurePort	string	Основной порт.
properties.primaryPeerAddressPrefix	string	Префикс первичного адреса.
properties.provisioningState	ProvisioningState	Состояние подготовки ресурса пиринга express route cross connection.
properties.secondaryAzurePort	string	Дополнительный порт.
properties.secondaryPeerAddressPrefix	string	Префикс вторичного адреса.
properties.sharedKey	string	Общий ключ.
properties.state	ExpressRoutePeeringState	Состояние пиринга.
properties.vlanId	integer	Идентификатор виртуальной локальной сети.

ExpressRoutePeeringState

Состояние пиринга.

Имя	Тип	Описание
Disabled	string
Enabled	string

ExpressRoutePeeringType

Тип пиринга.

Имя	Тип	Описание
AzurePrivatePeering	string
AzurePublicPeering	string
MicrosoftPeering	string

Ipv6ExpressRouteCircuitPeeringConfig

Содержит конфигурацию пиринга IPv6.

Имя	Тип	Описание
microsoftPeeringConfig	ExpressRouteCircuitPeeringConfig	Конфигурация пиринга Майкрософт.
primaryPeerAddressPrefix	string	Префикс первичного адреса.
routeFilter	SubResource	Ссылка на ресурс RouteFilter.
secondaryPeerAddressPrefix	string	Префикс вторичного адреса.
state	ExpressRouteCircuitPeeringState	Состояние пиринга.

ProvisioningState

Текущее состояние подготовки.

Имя	Тип	Описание
Deleting	string
Failed	string
Succeeded	string
Updating	string

ServiceProviderProvisioningState

Состояние ServiceProviderProvisioningState ресурса.

Имя	Тип	Описание
Deprovisioning	string
NotProvisioned	string
Provisioned	string
Provisioning	string

SubResource

Ссылка на другой подресурс.

Имя	Тип	Описание
id	string	Идентификатор ресурса.