Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
140 changes: 140 additions & 0 deletions sdk/peering/azure-mgmt-peering/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,145 @@
# Release History

## 2.0.0 (2025-05-12)

### Features Added

- Client `PeeringManagementClient` added operation group `cdn_peering_prefixes`
- Client `PeeringManagementClient` added operation group `looking_glass`
- Client `PeeringManagementClient` added operation group `registered_asns`
- Client `PeeringManagementClient` added operation group `registered_prefixes`
- Client `PeeringManagementClient` added operation group `received_routes`
- Client `PeeringManagementClient` added operation group `connection_monitor_tests`
- Client `PeeringManagementClient` added operation group `peering_service_countries`
- Client `PeeringManagementClient` added operation group `rp_unbilled_prefixes`
- Enum `ConnectionState` added member `EXTERNAL_BLOCKER`
- Enum `ConnectionState` added member `TYPE_CHANGE_IN_PROGRESS`
- Enum `ConnectionState` added member `TYPE_CHANGE_REQUESTED`
- Model `DirectConnection` added property `microsoft_tracking_id`
- Model `DirectConnection` added property `migration_work_window_bgp_session_same_device`
- Model `DirectConnection` added property `last_failure_time_utc`
- Model `DirectConnection` added property `error_message`
- Model `DirectConnection` added property `previous_connection_provisioning_state`
- Model `DirectConnection` added property `migration_work_window_tracker`
- Enum `DirectPeeringType` added member `EDGE_ZONE_FOR_OPERATORS`
- Enum `DirectPeeringType` added member `IX`
- Enum `DirectPeeringType` added member `IX_RS`
- Enum `DirectPeeringType` added member `PEER_PROP`
- Enum `DirectPeeringType` added member `VOICE`
- Enum `Enum0` added member `UNAVAILABLE`
- Model `ErrorResponse` added property `error`
- Model `ExchangeConnection` added property `migration_work_window_bgp_session_same_device`
- Model `ExchangeConnection` added property `last_failure_time_utc`
- Model `ExchangeConnection` added property `error_message`
- Model `ExchangeConnection` added property `previous_connection_provisioning_state`
- Model `ExchangeConnection` added property `migration_work_window_tracker`
- Enum `LearnedType` added member `VIA_SERVICE_PROVIDER`
- Model `Operation` added property `service_specification`
- Model `PeerAsn` added property `peer_contact_detail`
- Model `PeerAsn` added property `error_message`
- Model `Peering` added property `connectivity_probes`
- Model `PeeringService` added property `sku`
- Model `PeeringService` added property `provider_primary_peering_location`
- Model `PeeringService` added property `provider_backup_peering_location`
- Model `PeeringService` added property `log_analytics_workspace_properties`
- Model `PeeringServicePrefix` added property `error_message`
- Model `PeeringServicePrefix` added property `events`
- Model `PeeringServicePrefix` added property `peering_service_prefix_key`
- Model `PeeringServiceProvider` added property `peering_locations`
- Enum `PrefixValidationState` added member `WARNING`
- Added model `CdnPeeringPrefix`
- Added model `CdnPeeringPrefixListResult`
- Added enum `Command`
- Added model `ConnectionMonitorTest`
- Added model `ConnectionMonitorTestListResult`
- Added model `ConnectivityProbe`
- Added model `ContactDetail`
- Added enum `Enum11`
- Added enum `Enum13`
- Added model `ErrorDetail`
- Added enum `LegacyPeeringsKind`
- Added model `LogAnalyticsWorkspaceProperties`
- Added enum `LookingGlassCommand`
- Added model `LookingGlassOutput`
- Added enum `LookingGlassSourceType`
- Added model `MetricDimension`
- Added model `MetricSpecification`
- Added enum `PeeringLocationsDirectPeeringType`
- Added enum `PeeringLocationsKind`
- Added model `PeeringReceivedRoute`
- Added model `PeeringReceivedRouteListResult`
- Added model `PeeringRegisteredAsn`
- Added model `PeeringRegisteredAsnListResult`
- Added model `PeeringRegisteredPrefix`
- Added model `PeeringRegisteredPrefixListResult`
- Added model `PeeringServiceCountry`
- Added model `PeeringServiceCountryListResult`
- Added model `PeeringServicePrefixEvent`
- Added model `PeeringServiceSku`
- Added enum `PreviousConnectionProvisioningState`
- Added enum `Protocol`
- Added enum `Role`
- Added model `RpUnbilledPrefix`
- Added model `RpUnbilledPrefixListResult`
- Added model `ServiceSpecification`
- Model `LegacyPeeringsOperations` added parameter `kwargs` in method `__init__`
- Model `Operations` added parameter `kwargs` in method `__init__`
- Model `PeerAsnsOperations` added parameter `kwargs` in method `__init__`
- Model `PeeringLocationsOperations` added parameter `kwargs` in method `__init__`
- Model `PeeringServiceLocationsOperations` added parameter `kwargs` in method `__init__`
- Model `PeeringServiceProvidersOperations` added parameter `kwargs` in method `__init__`
- Model `PeeringServicesOperations` added parameter `kwargs` in method `__init__`
- Model `PeeringServicesOperations` added method `initialize_connection_monitor`
- Model `PeeringsOperations` added parameter `kwargs` in method `__init__`
- Model `PrefixesOperations` added parameter `kwargs` in method `__init__`
- Model `PrefixesOperations` added method `create_or_update`
- Model `PrefixesOperations` added method `delete`
- Added model `CdnPeeringPrefixesOperations`
- Added model `ConnectionMonitorTestsOperations`
- Added model `LookingGlassOperations`
- Added model `PeeringServiceCountriesOperations`
- Added model `ReceivedRoutesOperations`
- Added model `RegisteredAsnsOperations`
- Added model `RegisteredPrefixesOperations`
- Added model `RpUnbilledPrefixesOperations`
- Method `PeeringManagementClient.check_service_provider_availability` has a new overload `def check_service_provider_availability(self: None, check_service_provider_availability_input: CheckServiceProviderAvailabilityInput, content_type: str)`
- Method `PeeringManagementClient.check_service_provider_availability` has a new overload `def check_service_provider_availability(self: None, check_service_provider_availability_input: IO[bytes], content_type: str)`
- Method `PeerAsnsOperations.create_or_update` has a new overload `def create_or_update(self: None, peer_asn_name: str, peer_asn: PeerAsn, content_type: str)`
- Method `PeerAsnsOperations.create_or_update` has a new overload `def create_or_update(self: None, peer_asn_name: str, peer_asn: IO[bytes], content_type: str)`
- Method `PeeringManagementClientOperationsMixin.check_service_provider_availability` has a new overload `def check_service_provider_availability(self: None, check_service_provider_availability_input: CheckServiceProviderAvailabilityInput, content_type: str)`
- Method `PeeringManagementClientOperationsMixin.check_service_provider_availability` has a new overload `def check_service_provider_availability(self: None, check_service_provider_availability_input: IO[bytes], content_type: str)`
- Method `PeeringServicesOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_service_name: str, peering_service: PeeringService, content_type: str)`
- Method `PeeringServicesOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_service_name: str, peering_service: IO[bytes], content_type: str)`
- Method `PeeringServicesOperations.update` has a new overload `def update(self: None, resource_group_name: str, peering_service_name: str, tags: ResourceTags, content_type: str)`
- Method `PeeringServicesOperations.update` has a new overload `def update(self: None, resource_group_name: str, peering_service_name: str, tags: IO[bytes], content_type: str)`
- Method `PeeringsOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_name: str, peering: Peering, content_type: str)`
- Method `PeeringsOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_name: str, peering: IO[bytes], content_type: str)`
- Method `PeeringsOperations.update` has a new overload `def update(self: None, resource_group_name: str, peering_name: str, tags: ResourceTags, content_type: str)`
- Method `PeeringsOperations.update` has a new overload `def update(self: None, resource_group_name: str, peering_name: str, tags: IO[bytes], content_type: str)`
- Method `PrefixesOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_service_name: str, prefix_name: str, peering_service_prefix: PeeringServicePrefix, content_type: str)`
- Method `PrefixesOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_service_name: str, prefix_name: str, peering_service_prefix: IO[bytes], content_type: str)`
- Method `ConnectionMonitorTestsOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_service_name: str, connection_monitor_test_name: str, connection_monitor_test: ConnectionMonitorTest, content_type: str)`
- Method `ConnectionMonitorTestsOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_service_name: str, connection_monitor_test_name: str, connection_monitor_test: IO[bytes], content_type: str)`
- Method `RegisteredAsnsOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_name: str, registered_asn_name: str, registered_asn: PeeringRegisteredAsn, content_type: str)`
- Method `RegisteredAsnsOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_name: str, registered_asn_name: str, registered_asn: IO[bytes], content_type: str)`
- Method `RegisteredPrefixesOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_name: str, registered_prefix_name: str, registered_prefix: PeeringRegisteredPrefix, content_type: str)`
- Method `RegisteredPrefixesOperations.create_or_update` has a new overload `def create_or_update(self: None, resource_group_name: str, peering_name: str, registered_prefix_name: str, registered_prefix: IO[bytes], content_type: str)`

### Breaking Changes

- Deleted or renamed client operation group `PeeringManagementClient.peering_service_prefixes`
- Deleted or renamed enum value `Enum0.UN_AVAILABLE`
- Model `ErrorResponse` deleted or renamed its instance variable `code`
- Model `ErrorResponse` deleted or renamed its instance variable `message`
- Deleted or renamed enum value `LearnedType.VIA_PARTNER`
- Model `PeerAsn` deleted or renamed its instance variable `peer_contact_info`
- Deleted or renamed model `ContactInfo`
- Deleted or renamed model `Enum1`
- Deleted or renamed model `Enum14`
- Deleted or renamed model `Enum15`
- Deleted or renamed model `Name`
- Deleted or renamed model `PeeringServicePrefixesOperations`

## 2.0.0b1 (2022-11-01)

### Features Added
Expand Down
55 changes: 44 additions & 11 deletions sdk/peering/azure-mgmt-peering/README.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,61 @@
# Microsoft Azure SDK for Python

This is the Microsoft Azure Peering Management Client Library.
This package has been tested with Python 3.7+.
This package has been tested with Python 3.9+.
For a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all).

## _Disclaimer_

_Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691_

# Usage
## Getting started

### Prerequisites

To learn how to use this package, see the [quickstart guide](https://aka.ms/azsdk/python/mgmt)

For docs and references, see [Python SDK References](https://docs.microsoft.com/python/api/overview/azure/)
Code samples for this package can be found at [Peering Management](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing&terms=Getting%20started%20-%20Managing) on docs.microsoft.com.
Additional code samples for different Azure services are available at [Samples Repo](https://aka.ms/azsdk/python/mgmt/samples)
- Python 3.9+ is required to use this package.
- [Azure subscription](https://azure.microsoft.com/free/)

### Install the package

# Provide Feedback
```bash
pip install azure-mgmt-peering
pip install azure-identity
```

If you encounter any bugs or have suggestions, please file an issue in the
[Issues](https://github.com/Azure/azure-sdk-for-python/issues)
section of the project.
### Authentication

By default, [Azure Active Directory](https://aka.ms/awps/aad) token authentication depends on correct configuration of the following environment variables.

- `AZURE_CLIENT_ID` for Azure client ID.
- `AZURE_TENANT_ID` for Azure tenant ID.
- `AZURE_CLIENT_SECRET` for Azure client secret.

In addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`.

With above configuration, client can be authenticated by following code:

```python
from azure.identity import DefaultAzureCredential
from azure.mgmt.peering import PeeringManagementClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = PeeringManagementClient(credential=DefaultAzureCredential(), subscription_id=sub_id)
```

## Examples

Code samples for this package can be found at:
- [Search Peering Management](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing&terms=Getting%20started%20-%20Managing) on docs.microsoft.com
- [Azure Python Mgmt SDK Samples Repo](https://aka.ms/azsdk/python/mgmt/samples)


## Troubleshooting

## Next steps

## Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the
[Issues](https://github.com/Azure/azure-sdk-for-python/issues)
section of the project.
10 changes: 5 additions & 5 deletions sdk/peering/azure-mgmt-peering/_meta.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
{
"commit": "4522e1d3fb6dcb81bc63e3414d11dd7eaf08264b",
"commit": "2271c26de5b7855e1621e7d5d7dc0b6678d3b4a2",
"repository_url": "https://github.com/Azure/azure-rest-api-specs",
"autorest": "3.9.2",
"autorest": "3.10.2",
"use": [
"@autorest/python@6.2.1",
"@autorest/modelerfour@4.24.3"
"@autorest/python@6.34.1",
"@autorest/modelerfour@4.27.0"
],
"autorest_command": "autorest specification/peering/resource-manager/readme.md --generate-sample=True --include-x-ms-examples-original-file=True --python --python-sdks-folder=/home/vsts/work/1/azure-sdk-for-python/sdk --use=@autorest/python@6.2.1 --use=@autorest/modelerfour@4.24.3 --version=3.9.2 --version-tolerant=False",
"autorest_command": "autorest specification/peering/resource-manager/readme.md --generate-sample=True --generate-test=True --include-x-ms-examples-original-file=True --python --python-sdks-folder=/mnt/vss/_work/1/s/azure-sdk-for-python/sdk --use=@autorest/python@6.34.1 --use=@autorest/modelerfour@4.27.0 --version=3.10.2 --version-tolerant=False",
"readme": "specification/peering/resource-manager/readme.md"
}
12 changes: 9 additions & 3 deletions sdk/peering/azure-mgmt-peering/azure/mgmt/peering/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,22 +5,28 @@
# Code generated by Microsoft (R) AutoRest Code Generator.
# Changes may cause incorrect behavior and will be lost if the code is regenerated.
# --------------------------------------------------------------------------
# pylint: disable=wrong-import-position

from ._peering_management_client import PeeringManagementClient
from typing import TYPE_CHECKING

if TYPE_CHECKING:
from ._patch import * # pylint: disable=unused-wildcard-import

from ._peering_management_client import PeeringManagementClient # type: ignore
from ._version import VERSION

__version__ = VERSION

try:
from ._patch import __all__ as _patch_all
from ._patch import * # type: ignore # pylint: disable=unused-wildcard-import
from ._patch import *
except ImportError:
_patch_all = []
from ._patch import patch_sdk as _patch_sdk

__all__ = [
"PeeringManagementClient",
]
__all__.extend([p for p in _patch_all if p not in __all__])
__all__.extend([p for p in _patch_all if p not in __all__]) # pyright: ignore

_patch_sdk()
Original file line number Diff line number Diff line change
Expand Up @@ -6,26 +6,18 @@
# Changes may cause incorrect behavior and will be lost if the code is regenerated.
# --------------------------------------------------------------------------

import sys
from typing import Any, TYPE_CHECKING

from azure.core.configuration import Configuration
from azure.core.pipeline import policies
from azure.mgmt.core.policies import ARMChallengeAuthenticationPolicy, ARMHttpLoggingPolicy

from ._version import VERSION

if sys.version_info >= (3, 8):
from typing import Literal # pylint: disable=no-name-in-module, ungrouped-imports
else:
from typing_extensions import Literal # type: ignore # pylint: disable=ungrouped-imports

if TYPE_CHECKING:
# pylint: disable=unused-import,ungrouped-imports
from azure.core.credentials import TokenCredential


class PeeringManagementClientConfiguration(Configuration): # pylint: disable=too-many-instance-attributes
class PeeringManagementClientConfiguration: # pylint: disable=too-many-instance-attributes
"""Configuration for PeeringManagementClient.

Note that all parameters used to create this instance are saved as instance
Expand All @@ -35,14 +27,13 @@ class PeeringManagementClientConfiguration(Configuration): # pylint: disable=to
:type credential: ~azure.core.credentials.TokenCredential
:param subscription_id: The Azure subscription ID. Required.
:type subscription_id: str
:keyword api_version: Api Version. Default value is "2022-10-01". Note that overriding this
:keyword api_version: Api Version. Default value is "2025-05-01". Note that overriding this
default value may result in unsupported behavior.
:paramtype api_version: str
"""

def __init__(self, credential: "TokenCredential", subscription_id: str, **kwargs: Any) -> None:
super(PeeringManagementClientConfiguration, self).__init__(**kwargs)
api_version = kwargs.pop("api_version", "2022-10-01") # type: Literal["2022-10-01"]
api_version: str = kwargs.pop("api_version", "2025-05-01")

if credential is None:
raise ValueError("Parameter 'credential' must not be None.")
Expand All @@ -54,20 +45,18 @@ def __init__(self, credential: "TokenCredential", subscription_id: str, **kwargs
self.api_version = api_version
self.credential_scopes = kwargs.pop("credential_scopes", ["https://management.azure.com/.default"])
kwargs.setdefault("sdk_moniker", "mgmt-peering/{}".format(VERSION))
self.polling_interval = kwargs.get("polling_interval", 30)
self._configure(**kwargs)

def _configure(
self, **kwargs # type: Any
):
# type: (...) -> None
def _configure(self, **kwargs: Any) -> None:
self.user_agent_policy = kwargs.get("user_agent_policy") or policies.UserAgentPolicy(**kwargs)
self.headers_policy = kwargs.get("headers_policy") or policies.HeadersPolicy(**kwargs)
self.proxy_policy = kwargs.get("proxy_policy") or policies.ProxyPolicy(**kwargs)
self.logging_policy = kwargs.get("logging_policy") or policies.NetworkTraceLoggingPolicy(**kwargs)
self.http_logging_policy = kwargs.get("http_logging_policy") or ARMHttpLoggingPolicy(**kwargs)
self.retry_policy = kwargs.get("retry_policy") or policies.RetryPolicy(**kwargs)
self.custom_hook_policy = kwargs.get("custom_hook_policy") or policies.CustomHookPolicy(**kwargs)
self.redirect_policy = kwargs.get("redirect_policy") or policies.RedirectPolicy(**kwargs)
self.retry_policy = kwargs.get("retry_policy") or policies.RetryPolicy(**kwargs)
self.authentication_policy = kwargs.get("authentication_policy")
if self.credential and not self.authentication_policy:
self.authentication_policy = ARMChallengeAuthenticationPolicy(
Expand Down
Loading