updateSiteRackPhysicalProperties method

Future<UpdateSiteRackPhysicalPropertiesOutput> updateSiteRackPhysicalProperties({ required String siteId, FiberOpticCableType? fiberOpticCableType, MaximumSupportedWeightLbs? maximumSupportedWeightLbs, OpticalStandard? opticalStandard, PowerConnector? powerConnector, PowerDrawKva? powerDrawKva, PowerFeedDrop? powerFeedDrop, PowerPhase? powerPhase, UplinkCount? uplinkCount, UplinkGbps? uplinkGbps, })

Update the physical and logistical details for a rack at a site. For more information about hardware requirements for racks, see Network readiness checklist in the Amazon Web Services Outposts User Guide.

To update a rack at a site with an order of IN_PROGRESS, you must wait for the order to complete or cancel the order.

May throw AccessDeniedException. May throw ConflictException. May throw InternalServerException. May throw NotFoundException. May throw ValidationException.

Parameter siteId : The ID or the Amazon Resource Name (ARN) of the site.

Parameter fiberOpticCableType : The type of fiber that you will use to attach the Outpost to your network.

Parameter maximumSupportedWeightLbs : The maximum rack weight that this site can support. NO_LIMIT is over 2000lbs.

Parameter opticalStandard : The type of optical standard that you will use to attach the Outpost to your network. This field is dependent on uplink speed, fiber type, and distance to the upstream device. For more information about networking requirements for racks, see Network in the Amazon Web Services Outposts User Guide.

• OPTIC_10GBASE_SR: 10GBASE-SR
• OPTIC_10GBASE_IR: 10GBASE-IR
• OPTIC_10GBASE_LR: 10GBASE-LR
• OPTIC_40GBASE_SR: 40GBASE-SR
• OPTIC_40GBASE_ESR: 40GBASE-ESR
• OPTIC_40GBASE_IR4_LR4L: 40GBASE-IR (LR4L)
• OPTIC_40GBASE_LR4: 40GBASE-LR4
• OPTIC_100GBASE_SR4: 100GBASE-SR4
• OPTIC_100GBASE_CWDM4: 100GBASE-CWDM4
• OPTIC_100GBASE_LR4: 100GBASE-LR4
• OPTIC_100G_PSM4_MSA: 100G PSM4 MSA
• OPTIC_1000BASE_LX: 1000Base-LX
• OPTIC_1000BASE_SX : 1000Base-SX

Parameter powerConnector : The power connector that Amazon Web Services should plan to provide for connections to the hardware. Note the correlation between PowerPhase and PowerConnector.

• Single-phase AC feed
  • L6-30P – (common in US); 30A; single phase
  • IEC309 (blue) – P+N+E, 6hr; 32 A; single phase
• Three-phase AC feed
  • AH530P7W (red) – 3P+N+E, 7hr; 30A; three phase
  • AH532P6W (red) – 3P+N+E, 6hr; 32A; three phase
  • CS8365C – (common in US); 3P+E, 50A; three phase

Parameter powerDrawKva : The power draw, in kVA, available at the hardware placement position for the rack.

Parameter powerFeedDrop : Indicates whether the power feed comes above or below the rack.

Parameter powerPhase : The power option that you can provide for hardware.

• Single-phase AC feed: 200 V to 277 V, 50 Hz or 60 Hz
• Three-phase AC feed: 346 V to 480 V, 50 Hz or 60 Hz

Parameter uplinkCount : Racks come with two Outpost network devices. Depending on the supported uplink speed at the site, the Outpost network devices provide a variable number of uplinks. Specify the number of uplinks for each Outpost network device that you intend to use to connect the rack to your network. Note the correlation between UplinkGbps and UplinkCount.

• 1Gbps - Uplinks available: 1, 2, 4, 6, 8
• 10Gbps - Uplinks available: 1, 2, 4, 8, 12, 16
• 40 and 100 Gbps- Uplinks available: 1, 2, 4

Parameter uplinkGbps : The uplink speed the rack should support for the connection to the Region.

Implementation

Future<UpdateSiteRackPhysicalPropertiesOutput>
    updateSiteRackPhysicalProperties({
  required String siteId,
  FiberOpticCableType? fiberOpticCableType,
  MaximumSupportedWeightLbs? maximumSupportedWeightLbs,
  OpticalStandard? opticalStandard,
  PowerConnector? powerConnector,
  PowerDrawKva? powerDrawKva,
  PowerFeedDrop? powerFeedDrop,
  PowerPhase? powerPhase,
  UplinkCount? uplinkCount,
  UplinkGbps? uplinkGbps,
}) async {
  final $payload = <String, dynamic>{
    if (fiberOpticCableType != null)
      'FiberOpticCableType': fiberOpticCableType.value,
    if (maximumSupportedWeightLbs != null)
      'MaximumSupportedWeightLbs': maximumSupportedWeightLbs.value,
    if (opticalStandard != null) 'OpticalStandard': opticalStandard.value,
    if (powerConnector != null) 'PowerConnector': powerConnector.value,
    if (powerDrawKva != null) 'PowerDrawKva': powerDrawKva.value,
    if (powerFeedDrop != null) 'PowerFeedDrop': powerFeedDrop.value,
    if (powerPhase != null) 'PowerPhase': powerPhase.value,
    if (uplinkCount != null) 'UplinkCount': uplinkCount.value,
    if (uplinkGbps != null) 'UplinkGbps': uplinkGbps.value,
  };
  final response = await _protocol.send(
    payload: $payload,
    method: 'PATCH',
    requestUri:
        '/sites/${Uri.encodeComponent(siteId)}/rackPhysicalProperties',
    exceptionFnMap: _exceptionFns,
  );
  return UpdateSiteRackPhysicalPropertiesOutput.fromJson(response);
}