provides
This is the provides side of the interface layer, for use only by the Azure
integrator charm itself.
The flags that are set by the provides side of this interface are:
* **`endpoint.{endpoint_name}.requested`** This flag is set when there is
a new or updated request by a remote unit for Azure integration features.
The Azure integration charm should then iterate over each request, perform
whatever actions are necessary to satisfy those requests, and then mark
them as complete.
AzureIntegrationProvides
```python
AzureIntegrationProvides(self, endpoint_name, relation_ids=None)
```
Example usage:
```python
from charms.reactive import when, endpoint_from_flag
from charms import layer
@when('endpoint.azure.requests-pending')
def handle_requests():
azure = endpoint_from_flag('endpoint.azure.requests-pending')
for request in azure.requests:
if request.instance_tags:
layer.azure.tag_instance(
request.vm_name,
request.resource_group,
request.instance_tags)
if request.requested_load_balancer_management:
layer.azure.enable_load_balancer_management(
request.charm,
request.vm_name,
request.resource_group,
)
# ...
azure.mark_completed()
```
relation_ids
A list of the IDs of all established relations.
requests
A list of the new or updated `IntegrationRequests` that
have been made.
get_departed_charms
```python
AzureIntegrationProvides.get_departed_charms(self)
```
Get a list of all charms that have had all units depart since the
last time this was called.
mark_completed
```python
AzureIntegrationProvides.mark_completed(self)
```
Mark all requests as completed and remove the `requests-pending` flag.
IntegrationRequest
```python
IntegrationRequest(self, unit)
```
A request for integration from a single remote unit.
application_name
The name of the application making the request.
charm
The charm name reported for this request.
Mapping of tag names to values to apply to this instance.
is_changed
Whether this request has changed since the last time it was
marked completed (if ever).
model_uuid
The UUID of the model containing the application making this request.
relation_id
The ID of the relation for the unit making the request.
requested_block_storage_management
Flag indicating whether block storage management was requested.
requested_dns_management
Flag indicating whether DNS management was requested.
requested_instance_inspection
Flag indicating whether the ability to inspect instances was requested.
requested_network_management
Flag indicating whether the ability to manage networking was requested.
requested_object_storage_access
Flag indicating whether object storage access was requested.
requested_object_storage_management
Flag indicating whether object storage management was requested.
requested_security_management
Flag indicating whether security management was requested.
resource_group
The resource group reported for this request.
unit_name
The name of the unit making the request.
vm_id
The instance ID reported for this request.
vm_name
The instance name reported for this request.
mark_completed
```python
IntegrationRequest.mark_completed(self)
```
Mark this request as having been completed.