Skip to main content

ip_sec_connection_tunnel_shared_secrets

Creates, updates, deletes, gets or lists an ip_sec_connection_tunnel_shared_secrets resource.

Overview​

Nameip_sec_connection_tunnel_shared_secrets
TypeResource
Idoci.network.ip_sec_connection_tunnel_shared_secrets

Fields​

The following fields are returned by SELECT queries:

The information was retrieved.

NameDatatypeDescription
sharedSecretstringThe tunnel's shared secret (pre-shared key).

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectipscId, tunnelId, regionGets the specified tunnel's shared secret (pre-shared key). To get other information<br />about the tunnel, use [GetIPSecConnectionTunnel](#/en/iaas/latest/IPSecConnectionTunnel/GetIPSecConnectionTunnel).<br />
updateupdateipscId, tunnelId, regionif-matchUpdates the shared secret (pre-shared key) for the specified tunnel.<br /><br />Important: If you change the shared secret, the tunnel will go down while it's reprovisioned.<br />

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
ipscIdstringThe [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the IPSec connection.
regionstringOCI region identifier (e.g. us-ashburn-1, ap-sydney-1); resolves from OCI_REGION when not supplied in the query. (default: us-ashburn-1, x-stackQL-envVar: OCI_REGION)
tunnelIdstringThe [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the tunnel.
if-matchstringFor optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.

SELECT examples​

Gets the specified tunnel's shared secret (pre-shared key). To get other information<br />about the tunnel, use [GetIPSecConnectionTunnel](#/en/iaas/latest/IPSecConnectionTunnel/GetIPSecConnectionTunnel).<br />

SELECT
sharedSecret
FROM oci.network.ip_sec_connection_tunnel_shared_secrets
WHERE ipscId = '{{ ipscId }}' -- required
AND tunnelId = '{{ tunnelId }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples​

Updates the shared secret (pre-shared key) for the specified tunnel.<br /><br />Important: If you change the shared secret, the tunnel will go down while it's reprovisioned.<br />

UPDATE oci.network.ip_sec_connection_tunnel_shared_secrets
SET
sharedSecret = '{{ sharedSecret }}'
WHERE
ipscId = '{{ ipscId }}' --required
AND tunnelId = '{{ tunnelId }}' --required
AND region = '{{ region }}' --required
AND if-match = '{{ if-match}}'
RETURNING
sharedSecret;