cross_connect_status
Creates, updates, deletes, gets or lists a cross_connect_status resource.
Overview​
| Name | cross_connect_status |
| Type | Resource |
| Id | oci.network.cross_connect_status |
Fields​
The following fields are returned by SELECT queries:
- get
The cross-connect's status was retrieved.
| Name | Datatype | Description |
|---|---|---|
crossConnectId | string | The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the cross-connect. |
encryptionStatus | string | Encryption status of this cross connect. Possible values: * UP: Traffic is encrypted over this cross-connect * DOWN: Traffic is not encrypted over this cross-connect * CIPHER_MISMATCH: The MACsec encryption cipher doesn't match the cipher on the CPE * CKN_MISMATCH: The MACsec Connectivity association Key Name (CKN) doesn't match the CKN on the CPE * CAK_MISMATCH: The MACsec Connectivity Association Key (CAK) doesn't match the CAK on the CPE (UP, DOWN, CIPHER_MISMATCH, CKN_MISMATCH, CAK_MISMATCH) |
interfaceState | string | Indicates whether Oracle's side of the interface is up or down. (UP, DOWN) |
lightLevelIndBm | number (float) | The light level of the cross-connect (in dBm). Example: 14.0 |
lightLevelIndicator | string | Status indicator corresponding to the light level. * NO_LIGHT: No measurable light * LOW_WARN: There's measurable light but it's too low * HIGH_WARN: Light level is too high * BAD: There's measurable light but the signal-to-noise ratio is bad * GOOD: Good light level (NO_LIGHT, LOW_WARN, HIGH_WARN, BAD, GOOD) |
lightLevelsInDBm | array | The light levels of the cross-connect (in dBm). Example: [14.0, -14.0, 2.1, -10.1] |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | crossConnectId, region | Gets the status of the specified cross-connect.<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.
| Name | Datatype | Description |
|---|---|---|
crossConnectId | string | The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the cross-connect. |
region | string | OCI 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) |
SELECT examples​
- get
Gets the status of the specified cross-connect.<br />
SELECT
crossConnectId,
encryptionStatus,
interfaceState,
lightLevelIndBm,
lightLevelIndicator,
lightLevelsInDBm
FROM oci.network.cross_connect_status
WHERE crossConnectId = '{{ crossConnectId }}' -- required
AND region = '{{ region }}' -- required
;