Skip to main content

bastion_shareable_links

Creates, updates, deletes, gets or lists a bastion_shareable_links resource.

Overview

Namebastion_shareable_links
TypeResource
Idazure.network.bastion_shareable_links

Fields

The following fields are returned by SELECT queries:

Success. The operation returns a list of shareable links for the specified VMs, giving appropriate error messages as needed.

NameDatatypeDescription
bslstringThe unique Bastion Shareable Link to the virtual machine.
createdAtstringThe time when the link was created.
messagestringOptional field indicating the warning or error message related to the vm in case of partial failure.
vmobjectReference of the virtual machine resource.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresourceGroupName, bastionHostName, subscriptionIdReturn the Bastion Shareable Links for all the VMs specified in the request.
putexecresourceGroupName, bastionHostName, subscriptionIdCreates a Bastion Shareable Links for all the VMs specified in the request.
deleteexecresourceGroupName, bastionHostName, subscriptionIdDeletes the Bastion Shareable Links for all the VMs specified in the request.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
bastionHostNamestringThe name of the Bastion Host.
resourceGroupNamestringThe name of the resource group.
subscriptionIdstring (uuid)The ID of the target subscription. The value must be an UUID.

SELECT examples

Return the Bastion Shareable Links for all the VMs specified in the request.

SELECT
bsl,
createdAt,
message,
vm
FROM azure.network.bastion_shareable_links
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND bastionHostName = '{{ bastionHostName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;

Lifecycle Methods

Creates a Bastion Shareable Links for all the VMs specified in the request.

EXEC azure.network.bastion_shareable_links.put 
@resourceGroupName='{{ resourceGroupName }}' --required,
@bastionHostName='{{ bastionHostName }}' --required,
@subscriptionId='{{ subscriptionId }}' --required
@@json=
'{
"vms": "{{ vms }}"
}'
;