Compartir a través de

az peering peering

  • Referencia

Nota:

Esta referencia forma parte de la extensión de emparejamiento para la CLI de Azure (versión 2.3.1 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az peering peering . Obtenga más información sobre las extensiones.

Emparejamiento.

Comandos

Nombre Description Tipo Estado
az peering peering create

Crea un nuevo emparejamiento o actualiza un emparejamiento existente con el nombre especificado en la suscripción y el grupo de recursos especificados.

 Extensión GA
az peering peering delete

Elimina un emparejamiento existente con el nombre especificado en la suscripción y el grupo de recursos especificados.

 Extensión GA
az peering peering list

Enumera todos los emparejamientos de la suscripción especificada.

 Extensión GA
az peering peering show

Obtiene un emparejamiento existente con el nombre especificado en la suscripción y el grupo de recursos especificados.

 Extensión GA
az peering peering update

Novedades etiquetas para un emparejamiento con el nombre especificado en la suscripción y el grupo de recursos especificados.

 Extensión GA

az peering peering create

Crea un nuevo emparejamiento o actualiza un emparejamiento existente con el nombre especificado en la suscripción y el grupo de recursos especificados.

az peering peering create --kind {Direct, Exchange}
                          --location
                          --peering-name
                          --resource-group
                          --sku
                          [--direct]
                          [--exchange]
                          [--peering-location]
                          [--tags]

Ejemplos

Creación de un emparejamiento directo

az peering peering create --kind "Direct" --location "eastus" --direct "{\"connections\":[{\"bandwidthInMbps\":10000,\"bgpSession\":{\"maxPrefixesAdvertisedV4\":1000,\"maxPrefixesAdvertisedV6\":100,\"md5AuthenticationKey\":\"test-md5-auth-key\",\"sessionPrefixV4\":\"192.168.0.0/31\",\"sessionPrefixV6\":\"fd00::0/127\"},\"connectionIdentifier\":\"5F4CB5C7-6B43-4444-9338-9ABC72606C16\",\"peeringDBFacilityId\":99999,\"sessionAddressProvider\":\"Peer\",\"useForPeeringService\":false},{\"bandwidthInMbps\":10000,\"connectionIdentifier\":\"8AB00818-D533-4504-A25A-03A17F61201C\",\"peeringDBFacilityId\":99999,\"sessionAddressProvider\":\"Microsoft\",\"useForPeeringService\":true}],\"directPeeringType\":\"Edge\",\"peerAsn\":{\"id\":\"/subscriptions/subId/providers/Microsoft.Peering/peerAsns/myAsn1\"}}" --peering-location "peeringLocation0" --sku name="Basic_Direct_Free" --peering-name "peeringName" --resource-group "rgName"

Creación de un emparejamiento con el servidor de rutas de Exchange

az peering peering create --kind "Direct" --location "eastus" --direct "{\"connections\":[{\"bandwidthInMbps\":10000,\"bgpSession\":{\"maxPrefixesAdvertisedV4\":1000,\"maxPrefixesAdvertisedV6\":100,\"microsoftSessionIPv4Address\":\"192.168.0.123\",\"peerSessionIPv4Address\":\"192.168.0.234\",\"sessionPrefixV4\":\"192.168.0.0/24\"},\"connectionIdentifier\":\"5F4CB5C7-6B43-4444-9338-9ABC72606C16\",\"peeringDBFacilityId\":99999,\"sessionAddressProvider\":\"Peer\",\"useForPeeringService\":true}],\"directPeeringType\":\"IxRs\",\"peerAsn\":{\"id\":\"/subscriptions/subId/providers/Microsoft.Peering/peerAsns/myAsn1\"}}" --peering-location "peeringLocation0" --sku name="Premium_Direct_Free" --peering-name "peeringName" --resource-group "rgName"

Creación de un emparejamiento de Exchange

az peering peering create --kind "Exchange" --location "eastus" --exchange "{\"connections\":[{\"bgpSession\":{\"maxPrefixesAdvertisedV4\":1000,\"maxPrefixesAdvertisedV6\":100,\"md5AuthenticationKey\":\"test-md5-auth-key\",\"peerSessionIPv4Address\":\"192.168.2.1\",\"peerSessionIPv6Address\":\"fd00::1\"},\"connectionIdentifier\":\"CE495334-0E94-4E51-8164-8116D6CD284D\",\"peeringDBFacilityId\":99999},{\"bgpSession\":{\"maxPrefixesAdvertisedV4\":1000,\"maxPrefixesAdvertisedV6\":100,\"md5AuthenticationKey\":\"test-md5-auth-key\",\"peerSessionIPv4Address\":\"192.168.2.2\",\"peerSessionIPv6Address\":\"fd00::2\"},\"connectionIdentifier\":\"CDD8E673-CB07-47E6-84DE-3739F778762B\",\"peeringDBFacilityId\":99999}],\"peerAsn\":{\"id\":\"/subscriptions/subId/providers/Microsoft.Peering/peerAsns/myAsn1\"}}" --peering-location "peeringLocation0" --sku name="Basic_Exchange_Free" --peering-name "peeringName" --resource-group "rgName"

Parámetros requeridos

--kind

El tipo de emparejamiento.

Valores aceptados: Direct, Exchange
--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--peering-name

Nombre del emparejamiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sku

SKU que define el nivel y el tipo del emparejamiento. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... , keYs disponibles son: nombre, nivel, familia, tamaño.

Parámetros opcionales

--direct

Propiedades que definen un emparejamiento directo. Valor esperado: json-string/@json-file.

--exchange

Propiedades que definen un emparejamiento de intercambio. Valor esperado: json-string/@json-file.

--peering-location

Ubicación del emparejamiento.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az peering peering delete

Elimina un emparejamiento existente con el nombre especificado en la suscripción y el grupo de recursos especificados.

az peering peering delete --peering-name
                          --resource-group

Ejemplos

Eliminación de un emparejamiento

az peering peering delete --peering-name "peeringName" --resource-group "rgName"

Parámetros requeridos

--peering-name

Nombre del emparejamiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az peering peering list

Enumera todos los emparejamientos de la suscripción especificada.

az peering peering list [--resource-group]

Ejemplos

Enumeración de emparejamientos en un grupo de recursos

az peering peering list --resource-group "rgName"

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az peering peering show

Obtiene un emparejamiento existente con el nombre especificado en la suscripción y el grupo de recursos especificados.

az peering peering show --peering-name
                        --resource-group

Ejemplos

Obtención de un emparejamiento

az peering peering show --peering-name "peeringName" --resource-group "rgName"

Parámetros requeridos

--peering-name

Nombre del emparejamiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az peering peering update

Novedades etiquetas para un emparejamiento con el nombre especificado en la suscripción y el grupo de recursos especificados.

az peering peering update --peering-name
                          --resource-group
                          [--tags]

Ejemplos

Actualización de etiquetas de emparejamiento

az peering peering update --peering-name "peeringName" --resource-group "rgName" --tags tags={"tag0":"value0","tag1":"value1"}

Parámetros requeridos

--peering-name

Nombre del emparejamiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.