az peering asn

Note

This reference is part of the peering extension for the Azure CLI (version 2.3.1 or higher). The extension will automatically install the first time you run an az peering asn command. Learn more about extensions.

Peering asn.

Commands

Name Description Type Status
az peering asn create

Creates a new peer ASN or updates an existing peer ASN with the specified name under the given subscription.

Extension GA
az peering asn delete

Deletes an existing peer ASN with the specified name under the given subscription.

Extension GA
az peering asn list

Lists all of the peer ASNs under the given subscription.

Extension GA
az peering asn show

Gets the peer ASN with the specified name under the given subscription.

Extension GA

az peering asn create

Creates a new peer ASN or updates an existing peer ASN with the specified name under the given subscription.

az peering asn create --peer-asn-name
                      [--peer-asn]
                      [--peer-contact-detail]
                      [--peer-name]
                      [--validation-state {Approved, Failed, None, Pending}]

Examples

Create a peer ASN

az peering asn create --peer-asn 65000 --peer-contact-detail email="noc@contoso.com" phone="+1 (234) 567-8999" role="Noc" --peer-contact-detail email="abc@contoso.com" phone="+1 (234) 567-8900" role="Policy" --peer-contact-detail email="xyz@contoso.com" phone="+1 (234) 567-8900" role="Technical" --peer-name "Contoso" --peer-asn-name "peerAsnName"

Required Parameters

--peer-asn-name

The peer ASN name.

Optional Parameters

--peer-asn

The Autonomous System Number (ASN) of the peer.

--peer-contact-detail

The contact details of the peer. Expect value: KEY1=VALUE1 KEY2=VALUE2 ... , available KEYs are: role, email, phone.

--peer-name

The name of the peer.

--validation-state

The validation state of the ASN associated with the peer.

accepted values: Approved, Failed, None, Pending
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az peering asn delete

Deletes an existing peer ASN with the specified name under the given subscription.

az peering asn delete --peer-asn-name

Examples

Delete a peer ASN

az peering asn delete --peer-asn-name "peerAsnName"

Required Parameters

--peer-asn-name

The peer ASN name.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az peering asn list

Lists all of the peer ASNs under the given subscription.

az peering asn list

Examples

List peer ASNs in a subscription

az peering asn list
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az peering asn show

Gets the peer ASN with the specified name under the given subscription.

az peering asn show --peer-asn-name

Examples

Get a peer ASN

az peering asn show --peer-asn-name "peerAsnName"

Required Parameters

--peer-asn-name

The peer ASN name.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.