Outposts

Client

class Outposts.Client

A low-level client representing AWS Outposts

Amazon Web Services Outposts is a fully managed service that extends Amazon Web Services infrastructure, APIs, and tools to customer premises. By providing local access to Amazon Web Services managed infrastructure, Amazon Web Services Outposts enables customers to build and run applications on premises using the same programming interfaces as in Amazon Web Services Regions, while using local compute and storage resources for lower latency and local data processing needs.

client = session.create_client('outposts')

These are the available methods:

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
cancel_order(**kwargs)

Cancels an order for an Outpost.

See also: AWS API Documentation

Request Syntax

response = client.cancel_order(
    OrderId='string'
)
Parameters
OrderId (string) --

[REQUIRED]

The ID of the order to cancel.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

Exceptions

create_order(**kwargs)

Creates an order for an Outpost.

See also: AWS API Documentation

Request Syntax

response = client.create_order(
    OutpostIdentifier='string',
    LineItems=[
        {
            'CatalogItemId': 'string',
            'Quantity': 123
        },
    ],
    PaymentOption='ALL_UPFRONT'|'NO_UPFRONT'|'PARTIAL_UPFRONT',
    PaymentTerm='THREE_YEARS'
)
Parameters
  • OutpostIdentifier (string) --

    [REQUIRED]

    The ID or the Amazon Resource Name (ARN) of the Outpost.

  • LineItems (list) --

    [REQUIRED]

    The line items that make up the order.

    • (dict) --

      Information about a line item request.

      • CatalogItemId (string) --

        The ID of the catalog item.

      • Quantity (integer) --

        The quantity of a line item request.

  • PaymentOption (string) --

    [REQUIRED]

    The payment option for the order.

  • PaymentTerm (string) -- The payment terms for the order.
Return type

dict

Returns

Response Syntax

{
    'Order': {
        'OutpostId': 'string',
        'OrderId': 'string',
        'Status': 'RECEIVED'|'PENDING'|'PROCESSING'|'INSTALLING'|'FULFILLED'|'CANCELLED'|'PREPARING'|'IN_PROGRESS'|'COMPLETED'|'ERROR',
        'LineItems': [
            {
                'CatalogItemId': 'string',
                'LineItemId': 'string',
                'Quantity': 123,
                'Status': 'PREPARING'|'BUILDING'|'SHIPPED'|'DELIVERED'|'INSTALLING'|'INSTALLED'|'ERROR'|'CANCELLED'
            },
        ],
        'PaymentOption': 'ALL_UPFRONT'|'NO_UPFRONT'|'PARTIAL_UPFRONT',
        'OrderSubmissionDate': datetime(2015, 1, 1),
        'OrderFulfilledDate': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • Order (dict) --

      Information about this order.

      • OutpostId (string) --

        The ID of the Outpost in the order.

      • OrderId (string) --

        The ID of the order.

      • Status (string) --

        The status of the order.

        • PREPARING - Order is received and being prepared.
        • IN_PROGRESS - Order is either being built, shipped, or installed. To get more details, see the LineItem status.
        • COMPLETED - Order is complete.
        • CANCELLED - Order is cancelled.
        • ERROR - Customer should contact support.

        Note

        The following status are deprecated: RECEIVED , PENDING , PROCESSING , INSTALLING , and FULFILLED .

      • LineItems (list) --

        The line items for the order

        • (dict) --

          Information about a line item.

          • CatalogItemId (string) --

            The ID of the catalog item.

          • LineItemId (string) --

            The ID of the line item.

          • Quantity (integer) --

            The quantity of the line item.

          • Status (string) --

            The status of the line item.

      • PaymentOption (string) --

        The payment option for the order.

      • OrderSubmissionDate (datetime) --

        The submission date for the order.

      • OrderFulfilledDate (datetime) --

        The fulfillment date of the order.

Exceptions

create_outpost(**kwargs)

Creates an Outpost.

You can specify AvailabilityZone or AvailabilityZoneId .

See also: AWS API Documentation

Request Syntax

response = client.create_outpost(
    Name='string',
    Description='string',
    SiteId='string',
    AvailabilityZone='string',
    AvailabilityZoneId='string',
    Tags={
        'string': 'string'
    },
    SupportedHardwareType='RACK'|'SERVER'
)
Parameters
  • Name (string) --

    [REQUIRED]

    The name of the Outpost.

  • Description (string) -- The description of the Outpost.
  • SiteId (string) --

    [REQUIRED]

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

  • AvailabilityZone (string) -- The Availability Zone.
  • AvailabilityZoneId (string) -- The ID of the Availability Zone.
  • Tags (dict) --

    The tags to apply to the Outpost.

    • (string) --
      • (string) --
  • SupportedHardwareType (string) -- The type of hardware for this Outpost.
Return type

dict

Returns

Response Syntax

{
    'Outpost': {
        'OutpostId': 'string',
        'OwnerId': 'string',
        'OutpostArn': 'string',
        'SiteId': 'string',
        'Name': 'string',
        'Description': 'string',
        'LifeCycleStatus': 'string',
        'AvailabilityZone': 'string',
        'AvailabilityZoneId': 'string',
        'Tags': {
            'string': 'string'
        },
        'SiteArn': 'string',
        'SupportedHardwareType': 'RACK'|'SERVER'
    }
}

Response Structure

  • (dict) --

    • Outpost (dict) --

      Information about an Outpost.

      • OutpostId (string) --

        The ID of the Outpost.

      • OwnerId (string) --

        The Amazon Web Services account ID of the Outpost owner.

      • OutpostArn (string) --

        The Amazon Resource Name (ARN) of the Outpost.

      • SiteId (string) --

        The ID of the site.

      • Name (string) --

        The name of the Outpost.

      • Description (string) --

        The description of the Outpost.

      • LifeCycleStatus (string) --

        The life cycle status.

      • AvailabilityZone (string) --

        The Availability Zone.

      • AvailabilityZoneId (string) --

        The ID of the Availability Zone.

      • Tags (dict) --

        The Outpost tags.

        • (string) --
          • (string) --
      • SiteArn (string) --

        The Amazon Resource Name (ARN) of the site.

      • SupportedHardwareType (string) --

        The hardware type.

Exceptions

create_site(**kwargs)

Creates a site for an Outpost.

See also: AWS API Documentation

Request Syntax

response = client.create_site(
    Name='string',
    Description='string',
    Notes='string',
    Tags={
        'string': 'string'
    },
    OperatingAddress={
        'ContactName': 'string',
        'ContactPhoneNumber': 'string',
        'AddressLine1': 'string',
        'AddressLine2': 'string',
        'AddressLine3': 'string',
        'City': 'string',
        'StateOrRegion': 'string',
        'DistrictOrCounty': 'string',
        'PostalCode': 'string',
        'CountryCode': 'string',
        'Municipality': 'string'
    },
    ShippingAddress={
        'ContactName': 'string',
        'ContactPhoneNumber': 'string',
        'AddressLine1': 'string',
        'AddressLine2': 'string',
        'AddressLine3': 'string',
        'City': 'string',
        'StateOrRegion': 'string',
        'DistrictOrCounty': 'string',
        'PostalCode': 'string',
        'CountryCode': 'string',
        'Municipality': 'string'
    },
    RackPhysicalProperties={
        'PowerDrawKva': 'POWER_5_KVA'|'POWER_10_KVA'|'POWER_15_KVA',
        'PowerPhase': 'SINGLE_PHASE'|'THREE_PHASE',
        'PowerConnector': 'L6_30P'|'IEC309'|'AH530P7W'|'AH532P6W',
        'PowerFeedDrop': 'ABOVE_RACK'|'BELOW_RACK',
        'UplinkGbps': 'UPLINK_1G'|'UPLINK_10G'|'UPLINK_40G'|'UPLINK_100G',
        'UplinkCount': 'UPLINK_COUNT_1'|'UPLINK_COUNT_2'|'UPLINK_COUNT_3'|'UPLINK_COUNT_4'|'UPLINK_COUNT_5'|'UPLINK_COUNT_6'|'UPLINK_COUNT_7'|'UPLINK_COUNT_8'|'UPLINK_COUNT_12'|'UPLINK_COUNT_16',
        'FiberOpticCableType': 'SINGLE_MODE'|'MULTI_MODE',
        'OpticalStandard': 'OPTIC_10GBASE_SR'|'OPTIC_10GBASE_IR'|'OPTIC_10GBASE_LR'|'OPTIC_40GBASE_SR'|'OPTIC_40GBASE_ESR'|'OPTIC_40GBASE_IR4_LR4L'|'OPTIC_40GBASE_LR4'|'OPTIC_100GBASE_SR4'|'OPTIC_100GBASE_CWDM4'|'OPTIC_100GBASE_LR4'|'OPTIC_100G_PSM4_MSA'|'OPTIC_1000BASE_LX'|'OPTIC_1000BASE_SX',
        'MaximumSupportedWeightLbs': 'NO_LIMIT'|'MAX_1400_LBS'|'MAX_1600_LBS'|'MAX_1800_LBS'|'MAX_2000_LBS'
    }
)
Parameters
  • Name (string) --

    [REQUIRED]

    The name of the site.

  • Description (string) -- The description of the site.
  • Notes (string) -- Additional information that you provide about site access requirements, electrician scheduling, personal protective equipment, or regulation of equipment materials that could affect your installation process.
  • Tags (dict) --

    The tags to apply to a site.

    • (string) --
      • (string) --
  • OperatingAddress (dict) --

    The location to install and power on the hardware. This address might be different from the shipping address.

    • ContactName (string) --

      The name of the contact.

    • ContactPhoneNumber (string) --

      The phone number of the contact.

    • AddressLine1 (string) -- [REQUIRED]

      The first line of the address.

    • AddressLine2 (string) --

      The second line of the address.

    • AddressLine3 (string) --

      The third line of the address.

    • City (string) -- [REQUIRED]

      The city for the address.

    • StateOrRegion (string) -- [REQUIRED]

      The state for the address.

    • DistrictOrCounty (string) --

      The district or county for the address.

    • PostalCode (string) -- [REQUIRED]

      The postal code for the address.

    • CountryCode (string) -- [REQUIRED]

      The ISO-3166 two-letter country code for the address.

    • Municipality (string) --

      The municipality for the address.

  • ShippingAddress (dict) --

    The location to ship the hardware. This address might be different from the operating address.

    • ContactName (string) --

      The name of the contact.

    • ContactPhoneNumber (string) --

      The phone number of the contact.

    • AddressLine1 (string) -- [REQUIRED]

      The first line of the address.

    • AddressLine2 (string) --

      The second line of the address.

    • AddressLine3 (string) --

      The third line of the address.

    • City (string) -- [REQUIRED]

      The city for the address.

    • StateOrRegion (string) -- [REQUIRED]

      The state for the address.

    • DistrictOrCounty (string) --

      The district or county for the address.

    • PostalCode (string) -- [REQUIRED]

      The postal code for the address.

    • CountryCode (string) -- [REQUIRED]

      The ISO-3166 two-letter country code for the address.

    • Municipality (string) --

      The municipality for the address.

  • RackPhysicalProperties (dict) --

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

    • PowerDrawKva (string) --

      The power draw available at the hardware placement position for the rack.

    • PowerPhase (string) --

      The power option that you can provide for hardware.

    • PowerConnector (string) --

      The power connector for the hardware.

    • PowerFeedDrop (string) --

      The position of the power feed.

    • UplinkGbps (string) --

      The uplink speed the rack supports for the connection to the Region.

    • UplinkCount (string) --

      The number of uplinks each Outpost network device.

    • FiberOpticCableType (string) --

      The type of fiber used to attach the Outpost to the network.

    • OpticalStandard (string) --

      The type of optical standard used to attach the Outpost to the 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.

    • MaximumSupportedWeightLbs (string) --

      The maximum rack weight that this site can support. NO_LIMIT is over 2000 lbs (907 kg).

Return type

dict

Returns

Response Syntax

{
    'Site': {
        'SiteId': 'string',
        'AccountId': 'string',
        'Name': 'string',
        'Description': 'string',
        'Tags': {
            'string': 'string'
        },
        'SiteArn': 'string',
        'Notes': 'string',
        'OperatingAddressCountryCode': 'string',
        'OperatingAddressStateOrRegion': 'string',
        'OperatingAddressCity': 'string',
        'RackPhysicalProperties': {
            'PowerDrawKva': 'POWER_5_KVA'|'POWER_10_KVA'|'POWER_15_KVA',
            'PowerPhase': 'SINGLE_PHASE'|'THREE_PHASE',
            'PowerConnector': 'L6_30P'|'IEC309'|'AH530P7W'|'AH532P6W',
            'PowerFeedDrop': 'ABOVE_RACK'|'BELOW_RACK',
            'UplinkGbps': 'UPLINK_1G'|'UPLINK_10G'|'UPLINK_40G'|'UPLINK_100G',
            'UplinkCount': 'UPLINK_COUNT_1'|'UPLINK_COUNT_2'|'UPLINK_COUNT_3'|'UPLINK_COUNT_4'|'UPLINK_COUNT_5'|'UPLINK_COUNT_6'|'UPLINK_COUNT_7'|'UPLINK_COUNT_8'|'UPLINK_COUNT_12'|'UPLINK_COUNT_16',
            'FiberOpticCableType': 'SINGLE_MODE'|'MULTI_MODE',
            'OpticalStandard': 'OPTIC_10GBASE_SR'|'OPTIC_10GBASE_IR'|'OPTIC_10GBASE_LR'|'OPTIC_40GBASE_SR'|'OPTIC_40GBASE_ESR'|'OPTIC_40GBASE_IR4_LR4L'|'OPTIC_40GBASE_LR4'|'OPTIC_100GBASE_SR4'|'OPTIC_100GBASE_CWDM4'|'OPTIC_100GBASE_LR4'|'OPTIC_100G_PSM4_MSA'|'OPTIC_1000BASE_LX'|'OPTIC_1000BASE_SX',
            'MaximumSupportedWeightLbs': 'NO_LIMIT'|'MAX_1400_LBS'|'MAX_1600_LBS'|'MAX_1800_LBS'|'MAX_2000_LBS'
        }
    }
}

Response Structure

  • (dict) --

    • Site (dict) --

      Information about a site.

      • SiteId (string) --

        The ID of the site.

      • AccountId (string) --

        The ID of the Amazon Web Services account.

      • Name (string) --

        The name of the site.

      • Description (string) --

        The description of the site.

      • Tags (dict) --

        The site tags.

        • (string) --
          • (string) --
      • SiteArn (string) --

        The Amazon Resource Name (ARN) of the site.

      • Notes (string) --

        Notes about a site.

      • OperatingAddressCountryCode (string) --

        The ISO-3166 two-letter country code where the hardware is installed and powered on.

      • OperatingAddressStateOrRegion (string) --

        State or region where the hardware is installed and powered on.

      • OperatingAddressCity (string) --

        City where the hardware is installed and powered on.

      • RackPhysicalProperties (dict) --

        Information about the physical and logistical details for a rack at the site.

        • PowerDrawKva (string) --

          The power draw available at the hardware placement position for the rack.

        • PowerPhase (string) --

          The power option that you can provide for hardware.

        • PowerConnector (string) --

          The power connector for the hardware.

        • PowerFeedDrop (string) --

          The position of the power feed.

        • UplinkGbps (string) --

          The uplink speed the rack supports for the connection to the Region.

        • UplinkCount (string) --

          The number of uplinks each Outpost network device.

        • FiberOpticCableType (string) --

          The type of fiber used to attach the Outpost to the network.

        • OpticalStandard (string) --

          The type of optical standard used to attach the Outpost to the 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.

        • MaximumSupportedWeightLbs (string) --

          The maximum rack weight that this site can support. NO_LIMIT is over 2000 lbs (907 kg).

Exceptions

delete_outpost(**kwargs)

Deletes the Outpost.

See also: AWS API Documentation

Request Syntax

response = client.delete_outpost(
    OutpostId='string'
)
Parameters
OutpostId (string) --

[REQUIRED]

The ID or the Amazon Resource Name (ARN) of the Outpost.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

Exceptions

delete_site(**kwargs)

Deletes the site.

See also: AWS API Documentation

Request Syntax

response = client.delete_site(
    SiteId='string'
)
Parameters
SiteId (string) --

[REQUIRED]

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

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

Exceptions

get_catalog_item(**kwargs)

Gets information about a catalog item.

See also: AWS API Documentation

Request Syntax

response = client.get_catalog_item(
    CatalogItemId='string'
)
Parameters
CatalogItemId (string) --

[REQUIRED]

The ID of the catalog item.

Return type
dict
Returns
Response Syntax
{
    'CatalogItem': {
        'CatalogItemId': 'string',
        'ItemStatus': 'AVAILABLE'|'DISCONTINUED',
        'EC2Capacities': [
            {
                'Family': 'string',
                'MaxSize': 'string',
                'Quantity': 'string'
            },
        ],
        'PowerKva': ...,
        'WeightLbs': 123,
        'SupportedUplinkGbps': [
            123,
        ],
        'SupportedStorage': [
            'EBS'|'S3',
        ]
    }
}

Response Structure

  • (dict) --
    • CatalogItem (dict) --

      Information about this catalog item.

      • CatalogItemId (string) --

        The ID of the catalog item.

      • ItemStatus (string) --

        The status of a catalog item.

      • EC2Capacities (list) --

        Information about the EC2 capacity of an item.

        • (dict) --

          Information about EC2 capacity.

          • Family (string) --

            The family of the EC2 capacity.

          • MaxSize (string) --

            The maximum size of the EC2 capacity.

          • Quantity (string) --

            The quantity of the EC2 capacity.

      • PowerKva (float) --

        Information about the power draw of an item.

      • WeightLbs (integer) --

        The weight of the item in pounds.

      • SupportedUplinkGbps (list) --

        The uplink speed this catalog item requires for the connection to the Region.

        • (integer) --
      • SupportedStorage (list) --

        The supported storage options for the catalog item.

        • (string) --

Exceptions

get_order(**kwargs)

Gets an order.

See also: AWS API Documentation

Request Syntax

response = client.get_order(
    OrderId='string'
)
Parameters
OrderId (string) --

[REQUIRED]

The ID of the order.

Return type
dict
Returns
Response Syntax
{
    'Order': {
        'OutpostId': 'string',
        'OrderId': 'string',
        'Status': 'RECEIVED'|'PENDING'|'PROCESSING'|'INSTALLING'|'FULFILLED'|'CANCELLED'|'PREPARING'|'IN_PROGRESS'|'COMPLETED'|'ERROR',
        'LineItems': [
            {
                'CatalogItemId': 'string',
                'LineItemId': 'string',
                'Quantity': 123,
                'Status': 'PREPARING'|'BUILDING'|'SHIPPED'|'DELIVERED'|'INSTALLING'|'INSTALLED'|'ERROR'|'CANCELLED'
            },
        ],
        'PaymentOption': 'ALL_UPFRONT'|'NO_UPFRONT'|'PARTIAL_UPFRONT',
        'OrderSubmissionDate': datetime(2015, 1, 1),
        'OrderFulfilledDate': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --
    • Order (dict) --

      Information about an order.

      • OutpostId (string) --

        The ID of the Outpost in the order.

      • OrderId (string) --

        The ID of the order.

      • Status (string) --

        The status of the order.

        • PREPARING - Order is received and being prepared.
        • IN_PROGRESS - Order is either being built, shipped, or installed. To get more details, see the LineItem status.
        • COMPLETED - Order is complete.
        • CANCELLED - Order is cancelled.
        • ERROR - Customer should contact support.

        Note

        The following status are deprecated: RECEIVED , PENDING , PROCESSING , INSTALLING , and FULFILLED .

      • LineItems (list) --

        The line items for the order

        • (dict) --

          Information about a line item.

          • CatalogItemId (string) --

            The ID of the catalog item.

          • LineItemId (string) --

            The ID of the line item.

          • Quantity (integer) --

            The quantity of the line item.

          • Status (string) --

            The status of the line item.

      • PaymentOption (string) --

        The payment option for the order.

      • OrderSubmissionDate (datetime) --

        The submission date for the order.

      • OrderFulfilledDate (datetime) --

        The fulfillment date of the order.

Exceptions

get_outpost(**kwargs)

Gets information about the specified Outpost.

See also: AWS API Documentation

Request Syntax

response = client.get_outpost(
    OutpostId='string'
)
Parameters
OutpostId (string) --

[REQUIRED]

The ID or the Amazon Resource Name (ARN) of the Outpost.

Return type
dict
Returns
Response Syntax
{
    'Outpost': {
        'OutpostId': 'string',
        'OwnerId': 'string',
        'OutpostArn': 'string',
        'SiteId': 'string',
        'Name': 'string',
        'Description': 'string',
        'LifeCycleStatus': 'string',
        'AvailabilityZone': 'string',
        'AvailabilityZoneId': 'string',
        'Tags': {
            'string': 'string'
        },
        'SiteArn': 'string',
        'SupportedHardwareType': 'RACK'|'SERVER'
    }
}

Response Structure

  • (dict) --
    • Outpost (dict) --

      Information about an Outpost.

      • OutpostId (string) --

        The ID of the Outpost.

      • OwnerId (string) --

        The Amazon Web Services account ID of the Outpost owner.

      • OutpostArn (string) --

        The Amazon Resource Name (ARN) of the Outpost.

      • SiteId (string) --

        The ID of the site.

      • Name (string) --

        The name of the Outpost.

      • Description (string) --

        The description of the Outpost.

      • LifeCycleStatus (string) --

        The life cycle status.

      • AvailabilityZone (string) --

        The Availability Zone.

      • AvailabilityZoneId (string) --

        The ID of the Availability Zone.

      • Tags (dict) --

        The Outpost tags.

        • (string) --
          • (string) --
      • SiteArn (string) --

        The Amazon Resource Name (ARN) of the site.

      • SupportedHardwareType (string) --

        The hardware type.

Exceptions

get_outpost_instance_types(**kwargs)

Lists the instance types for the specified Outpost.

See also: AWS API Documentation

Request Syntax

response = client.get_outpost_instance_types(
    OutpostId='string',
    NextToken='string',
    MaxResults=123
)
Parameters
  • OutpostId (string) --

    [REQUIRED]

    The ID or the Amazon Resource Name (ARN) of the Outpost.

  • NextToken (string) -- The pagination token.
  • MaxResults (integer) -- The maximum page size.
Return type

dict

Returns

Response Syntax

{
    'InstanceTypes': [
        {
            'InstanceType': 'string'
        },
    ],
    'NextToken': 'string',
    'OutpostId': 'string',
    'OutpostArn': 'string'
}

Response Structure

  • (dict) --

    • InstanceTypes (list) --

      Information about the instance types.

      • (dict) --

        Information about an instance type.

        • InstanceType (string) --

          The instance type.

    • NextToken (string) --

      The pagination token.

    • OutpostId (string) --

      The ID of the Outpost.

    • OutpostArn (string) --

      The Amazon Resource Name (ARN) of the Outpost.

Exceptions

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_site(**kwargs)

Gets information about the specified Outpost site.

See also: AWS API Documentation

Request Syntax

response = client.get_site(
    SiteId='string'
)
Parameters
SiteId (string) --

[REQUIRED]

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

Return type
dict
Returns
Response Syntax
{
    'Site': {
        'SiteId': 'string',
        'AccountId': 'string',
        'Name': 'string',
        'Description': 'string',
        'Tags': {
            'string': 'string'
        },
        'SiteArn': 'string',
        'Notes': 'string',
        'OperatingAddressCountryCode': 'string',
        'OperatingAddressStateOrRegion': 'string',
        'OperatingAddressCity': 'string',
        'RackPhysicalProperties': {
            'PowerDrawKva': 'POWER_5_KVA'|'POWER_10_KVA'|'POWER_15_KVA',
            'PowerPhase': 'SINGLE_PHASE'|'THREE_PHASE',
            'PowerConnector': 'L6_30P'|'IEC309'|'AH530P7W'|'AH532P6W',
            'PowerFeedDrop': 'ABOVE_RACK'|'BELOW_RACK',
            'UplinkGbps': 'UPLINK_1G'|'UPLINK_10G'|'UPLINK_40G'|'UPLINK_100G',
            'UplinkCount': 'UPLINK_COUNT_1'|'UPLINK_COUNT_2'|'UPLINK_COUNT_3'|'UPLINK_COUNT_4'|'UPLINK_COUNT_5'|'UPLINK_COUNT_6'|'UPLINK_COUNT_7'|'UPLINK_COUNT_8'|'UPLINK_COUNT_12'|'UPLINK_COUNT_16',
            'FiberOpticCableType': 'SINGLE_MODE'|'MULTI_MODE',
            'OpticalStandard': 'OPTIC_10GBASE_SR'|'OPTIC_10GBASE_IR'|'OPTIC_10GBASE_LR'|'OPTIC_40GBASE_SR'|'OPTIC_40GBASE_ESR'|'OPTIC_40GBASE_IR4_LR4L'|'OPTIC_40GBASE_LR4'|'OPTIC_100GBASE_SR4'|'OPTIC_100GBASE_CWDM4'|'OPTIC_100GBASE_LR4'|'OPTIC_100G_PSM4_MSA'|'OPTIC_1000BASE_LX'|'OPTIC_1000BASE_SX',
            'MaximumSupportedWeightLbs': 'NO_LIMIT'|'MAX_1400_LBS'|'MAX_1600_LBS'|'MAX_1800_LBS'|'MAX_2000_LBS'
        }
    }
}

Response Structure

  • (dict) --
    • Site (dict) --

      Information about a site.

      • SiteId (string) --

        The ID of the site.

      • AccountId (string) --

        The ID of the Amazon Web Services account.

      • Name (string) --

        The name of the site.

      • Description (string) --

        The description of the site.

      • Tags (dict) --

        The site tags.

        • (string) --
          • (string) --
      • SiteArn (string) --

        The Amazon Resource Name (ARN) of the site.

      • Notes (string) --

        Notes about a site.

      • OperatingAddressCountryCode (string) --

        The ISO-3166 two-letter country code where the hardware is installed and powered on.

      • OperatingAddressStateOrRegion (string) --

        State or region where the hardware is installed and powered on.

      • OperatingAddressCity (string) --

        City where the hardware is installed and powered on.

      • RackPhysicalProperties (dict) --

        Information about the physical and logistical details for a rack at the site.

        • PowerDrawKva (string) --

          The power draw available at the hardware placement position for the rack.

        • PowerPhase (string) --

          The power option that you can provide for hardware.

        • PowerConnector (string) --

          The power connector for the hardware.

        • PowerFeedDrop (string) --

          The position of the power feed.

        • UplinkGbps (string) --

          The uplink speed the rack supports for the connection to the Region.

        • UplinkCount (string) --

          The number of uplinks each Outpost network device.

        • FiberOpticCableType (string) --

          The type of fiber used to attach the Outpost to the network.

        • OpticalStandard (string) --

          The type of optical standard used to attach the Outpost to the 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.

        • MaximumSupportedWeightLbs (string) --

          The maximum rack weight that this site can support. NO_LIMIT is over 2000 lbs (907 kg).

Exceptions

get_site_address(**kwargs)

Gets the site address.

See also: AWS API Documentation

Request Syntax

response = client.get_site_address(
    SiteId='string',
    AddressType='SHIPPING_ADDRESS'|'OPERATING_ADDRESS'
)
Parameters
  • SiteId (string) --

    [REQUIRED]

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

  • AddressType (string) --

    [REQUIRED]

    The type of the address you request.

Return type

dict

Returns

Response Syntax

{
    'SiteId': 'string',
    'AddressType': 'SHIPPING_ADDRESS'|'OPERATING_ADDRESS',
    'Address': {
        'ContactName': 'string',
        'ContactPhoneNumber': 'string',
        'AddressLine1': 'string',
        'AddressLine2': 'string',
        'AddressLine3': 'string',
        'City': 'string',
        'StateOrRegion': 'string',
        'DistrictOrCounty': 'string',
        'PostalCode': 'string',
        'CountryCode': 'string',
        'Municipality': 'string'
    }
}

Response Structure

  • (dict) --

    • SiteId (string) --

      The ID of the site.

    • AddressType (string) --

      The type of the address you receive.

    • Address (dict) --

      Information about the address.

      • ContactName (string) --

        The name of the contact.

      • ContactPhoneNumber (string) --

        The phone number of the contact.

      • AddressLine1 (string) --

        The first line of the address.

      • AddressLine2 (string) --

        The second line of the address.

      • AddressLine3 (string) --

        The third line of the address.

      • City (string) --

        The city for the address.

      • StateOrRegion (string) --

        The state for the address.

      • DistrictOrCounty (string) --

        The district or county for the address.

      • PostalCode (string) --

        The postal code for the address.

      • CountryCode (string) --

        The ISO-3166 two-letter country code for the address.

      • Municipality (string) --

        The municipality for the address.

Exceptions

get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_catalog_items(**kwargs)

Use to create a list of every item in the catalog. Add filters to your request to return a more specific list of results. Use filters to match an item class, storage option, or EC2 family.

If you specify multiple filters, the filters are joined with an AND , and the request returns only results that match all of the specified filters.

See also: AWS API Documentation

Request Syntax

response = client.list_catalog_items(
    NextToken='string',
    MaxResults=123,
    ItemClassFilter=[
        'RACK'|'SERVER',
    ],
    SupportedStorageFilter=[
        'EBS'|'S3',
    ],
    EC2FamilyFilter=[
        'string',
    ]
)
Parameters
  • NextToken (string) -- The pagination token.
  • MaxResults (integer) -- The maximum page size.
  • ItemClassFilter (list) --

    A filter for the class of items in the catalog.

    Filter values are case sensitive. If you specify multiple values for a filter, the values are joined with an OR , and the request returns all results that match any of the specified values.

    • (string) --
  • SupportedStorageFilter (list) --

    A filter for the storage options of items in the catalog.

    Filter values are case sensitive. If you specify multiple values for a filter, the values are joined with an OR , and the request returns all results that match any of the specified values.

    • (string) --
  • EC2FamilyFilter (list) --

    A filter for EC2 family options for items in the catalog.

    Filter values are case sensitive. If you specify multiple values for a filter, the values are joined with an OR , and the request returns all results that match any of the specified values.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'CatalogItems': [
        {
            'CatalogItemId': 'string',
            'ItemStatus': 'AVAILABLE'|'DISCONTINUED',
            'EC2Capacities': [
                {
                    'Family': 'string',
                    'MaxSize': 'string',
                    'Quantity': 'string'
                },
            ],
            'PowerKva': ...,
            'WeightLbs': 123,
            'SupportedUplinkGbps': [
                123,
            ],
            'SupportedStorage': [
                'EBS'|'S3',
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • CatalogItems (list) --

      Information about the catalog items.

      • (dict) --

        Information about a catalog item.

        • CatalogItemId (string) --

          The ID of the catalog item.

        • ItemStatus (string) --

          The status of a catalog item.

        • EC2Capacities (list) --

          Information about the EC2 capacity of an item.

          • (dict) --

            Information about EC2 capacity.

            • Family (string) --

              The family of the EC2 capacity.

            • MaxSize (string) --

              The maximum size of the EC2 capacity.

            • Quantity (string) --

              The quantity of the EC2 capacity.

        • PowerKva (float) --

          Information about the power draw of an item.

        • WeightLbs (integer) --

          The weight of the item in pounds.

        • SupportedUplinkGbps (list) --

          The uplink speed this catalog item requires for the connection to the Region.

          • (integer) --
        • SupportedStorage (list) --

          The supported storage options for the catalog item.

          • (string) --
    • NextToken (string) --

      The pagination token.

Exceptions

list_orders(**kwargs)

Create a list of the Outpost orders for your Amazon Web Services account. You can filter your request by Outpost to return a more specific list of results.

See also: AWS API Documentation

Request Syntax

response = client.list_orders(
    OutpostIdentifierFilter='string',
    NextToken='string',
    MaxResults=123
)
Parameters
  • OutpostIdentifierFilter (string) -- The ID or the Amazon Resource Name (ARN) of the Outpost.
  • NextToken (string) -- The pagination token.
  • MaxResults (integer) -- The maximum page size.
Return type

dict

Returns

Response Syntax

{
    'Orders': [
        {
            'OutpostId': 'string',
            'OrderId': 'string',
            'OrderType': 'OUTPOST'|'REPLACEMENT',
            'Status': 'RECEIVED'|'PENDING'|'PROCESSING'|'INSTALLING'|'FULFILLED'|'CANCELLED'|'PREPARING'|'IN_PROGRESS'|'COMPLETED'|'ERROR',
            'LineItemCountsByStatus': {
                'string': 123
            },
            'OrderSubmissionDate': datetime(2015, 1, 1),
            'OrderFulfilledDate': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Orders (list) --

      Information about the orders.

      • (dict) --

        A summary of line items in your order.

        • OutpostId (string) --

          The ID of the Outpost.

        • OrderId (string) --

          The ID of the order.

        • OrderType (string) --

          The type of order.

        • Status (string) --

          The status of the order.

          • PREPARING - Order is received and is being prepared.
          • IN_PROGRESS - Order is either being built, shipped, or installed. For more information, see the LineItem status.
          • COMPLETED - Order is complete.
          • CANCELLED - Order is cancelled.
          • ERROR - Customer should contact support.

          Note

          The following statuses are deprecated: RECEIVED , PENDING , PROCESSING , INSTALLING , and FULFILLED .

        • LineItemCountsByStatus (dict) --

          The status of all line items in the order.

          • (string) --
            • (integer) --
        • OrderSubmissionDate (datetime) --

          Submission date for the order.

        • OrderFulfilledDate (datetime) --

          Fulfilment date for the order.

    • NextToken (string) --

      The pagination token.

Exceptions

list_outposts(**kwargs)

Create a list of the Outposts for your Amazon Web Services account. Add filters to your request to return a more specific list of results. Use filters to match an Outpost lifecycle status, Availability Zone (us-east-1a ), and AZ ID (use1-az1 ).

If you specify multiple filters, the filters are joined with an AND , and the request returns only results that match all of the specified filters.

See also: AWS API Documentation

Request Syntax

response = client.list_outposts(
    NextToken='string',
    MaxResults=123,
    LifeCycleStatusFilter=[
        'string',
    ],
    AvailabilityZoneFilter=[
        'string',
    ],
    AvailabilityZoneIdFilter=[
        'string',
    ]
)
Parameters
  • NextToken (string) -- The pagination token.
  • MaxResults (integer) -- The maximum page size.
  • LifeCycleStatusFilter (list) --

    A filter for the lifecycle status of the Outpost.

    Filter values are case sensitive. If you specify multiple values for a filter, the values are joined with an OR , and the request returns all results that match any of the specified values.

    • (string) --

      The life cycle status.

  • AvailabilityZoneFilter (list) --

    A filter for the Availability Zone (us-east-1a ) of the Outpost.

    Filter values are case sensitive. If you specify multiple values for a filter, the values are joined with an OR , and the request returns all results that match any of the specified values.

    • (string) --

      The Availability Zone.

  • AvailabilityZoneIdFilter (list) --

    A filter for the AZ IDs (use1-az1 ) of the Outpost.

    Filter values are case sensitive. If you specify multiple values for a filter, the values are joined with an OR , and the request returns all results that match any of the specified values.

    • (string) --

      The ID of the Availability Zone.

Return type

dict

Returns

Response Syntax

{
    'Outposts': [
        {
            'OutpostId': 'string',
            'OwnerId': 'string',
            'OutpostArn': 'string',
            'SiteId': 'string',
            'Name': 'string',
            'Description': 'string',
            'LifeCycleStatus': 'string',
            'AvailabilityZone': 'string',
            'AvailabilityZoneId': 'string',
            'Tags': {
                'string': 'string'
            },
            'SiteArn': 'string',
            'SupportedHardwareType': 'RACK'|'SERVER'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Outposts (list) --

      Information about the Outposts.

      • (dict) --

        Information about an Outpost.

        • OutpostId (string) --

          The ID of the Outpost.

        • OwnerId (string) --

          The Amazon Web Services account ID of the Outpost owner.

        • OutpostArn (string) --

          The Amazon Resource Name (ARN) of the Outpost.

        • SiteId (string) --

          The ID of the site.

        • Name (string) --

          The name of the Outpost.

        • Description (string) --

          The description of the Outpost.

        • LifeCycleStatus (string) --

          The life cycle status.

        • AvailabilityZone (string) --

          The Availability Zone.

        • AvailabilityZoneId (string) --

          The ID of the Availability Zone.

        • Tags (dict) --

          The Outpost tags.

          • (string) --
            • (string) --
        • SiteArn (string) --

          The Amazon Resource Name (ARN) of the site.

        • SupportedHardwareType (string) --

          The hardware type.

    • NextToken (string) --

      The pagination token.

Exceptions

list_sites(**kwargs)

Lists the sites for your Amazon Web Services account.

See also: AWS API Documentation

Request Syntax

response = client.list_sites(
    NextToken='string',
    MaxResults=123
)
Parameters
  • NextToken (string) -- The pagination token.
  • MaxResults (integer) -- The maximum page size.
Return type

dict

Returns

Response Syntax

{
    'Sites': [
        {
            'SiteId': 'string',
            'AccountId': 'string',
            'Name': 'string',
            'Description': 'string',
            'Tags': {
                'string': 'string'
            },
            'SiteArn': 'string',
            'Notes': 'string',
            'OperatingAddressCountryCode': 'string',
            'OperatingAddressStateOrRegion': 'string',
            'OperatingAddressCity': 'string',
            'RackPhysicalProperties': {
                'PowerDrawKva': 'POWER_5_KVA'|'POWER_10_KVA'|'POWER_15_KVA',
                'PowerPhase': 'SINGLE_PHASE'|'THREE_PHASE',
                'PowerConnector': 'L6_30P'|'IEC309'|'AH530P7W'|'AH532P6W',
                'PowerFeedDrop': 'ABOVE_RACK'|'BELOW_RACK',
                'UplinkGbps': 'UPLINK_1G'|'UPLINK_10G'|'UPLINK_40G'|'UPLINK_100G',
                'UplinkCount': 'UPLINK_COUNT_1'|'UPLINK_COUNT_2'|'UPLINK_COUNT_3'|'UPLINK_COUNT_4'|'UPLINK_COUNT_5'|'UPLINK_COUNT_6'|'UPLINK_COUNT_7'|'UPLINK_COUNT_8'|'UPLINK_COUNT_12'|'UPLINK_COUNT_16',
                'FiberOpticCableType': 'SINGLE_MODE'|'MULTI_MODE',
                'OpticalStandard': 'OPTIC_10GBASE_SR'|'OPTIC_10GBASE_IR'|'OPTIC_10GBASE_LR'|'OPTIC_40GBASE_SR'|'OPTIC_40GBASE_ESR'|'OPTIC_40GBASE_IR4_LR4L'|'OPTIC_40GBASE_LR4'|'OPTIC_100GBASE_SR4'|'OPTIC_100GBASE_CWDM4'|'OPTIC_100GBASE_LR4'|'OPTIC_100G_PSM4_MSA'|'OPTIC_1000BASE_LX'|'OPTIC_1000BASE_SX',
                'MaximumSupportedWeightLbs': 'NO_LIMIT'|'MAX_1400_LBS'|'MAX_1600_LBS'|'MAX_1800_LBS'|'MAX_2000_LBS'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Sites (list) --

      Information about the sites.

      • (dict) --

        Information about a site.

        • SiteId (string) --

          The ID of the site.

        • AccountId (string) --

          The ID of the Amazon Web Services account.

        • Name (string) --

          The name of the site.

        • Description (string) --

          The description of the site.

        • Tags (dict) --

          The site tags.

          • (string) --
            • (string) --
        • SiteArn (string) --

          The Amazon Resource Name (ARN) of the site.

        • Notes (string) --

          Notes about a site.

        • OperatingAddressCountryCode (string) --

          The ISO-3166 two-letter country code where the hardware is installed and powered on.

        • OperatingAddressStateOrRegion (string) --

          State or region where the hardware is installed and powered on.

        • OperatingAddressCity (string) --

          City where the hardware is installed and powered on.

        • RackPhysicalProperties (dict) --

          Information about the physical and logistical details for a rack at the site.

          • PowerDrawKva (string) --

            The power draw available at the hardware placement position for the rack.

          • PowerPhase (string) --

            The power option that you can provide for hardware.

          • PowerConnector (string) --

            The power connector for the hardware.

          • PowerFeedDrop (string) --

            The position of the power feed.

          • UplinkGbps (string) --

            The uplink speed the rack supports for the connection to the Region.

          • UplinkCount (string) --

            The number of uplinks each Outpost network device.

          • FiberOpticCableType (string) --

            The type of fiber used to attach the Outpost to the network.

          • OpticalStandard (string) --

            The type of optical standard used to attach the Outpost to the 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.

          • MaximumSupportedWeightLbs (string) --

            The maximum rack weight that this site can support. NO_LIMIT is over 2000 lbs (907 kg).

    • NextToken (string) --

      The pagination token.

Exceptions

list_tags_for_resource(**kwargs)

Lists the tags for the specified resource.

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    ResourceArn='string'
)
Parameters
ResourceArn (string) --

[REQUIRED]

The Amazon Resource Name (ARN) of the resource.

Return type
dict
Returns
Response Syntax
{
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --
    • Tags (dict) --

      The resource tags.

      • (string) --
        • (string) --

Exceptions

tag_resource(**kwargs)

Adds tags to the specified resource.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    ResourceArn='string',
    Tags={
        'string': 'string'
    }
)
Parameters
  • ResourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the resource.

  • Tags (dict) --

    [REQUIRED]

    The tags to add to the resource.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

untag_resource(**kwargs)

Removes tags from the specified resource.

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    ResourceArn='string',
    TagKeys=[
        'string',
    ]
)
Parameters
  • ResourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the resource.

  • TagKeys (list) --

    [REQUIRED]

    The tag keys.

    • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

update_outpost(**kwargs)

Updates an Outpost.

See also: AWS API Documentation

Request Syntax

response = client.update_outpost(
    OutpostId='string',
    Name='string',
    Description='string',
    SupportedHardwareType='RACK'|'SERVER'
)
Parameters
  • OutpostId (string) --

    [REQUIRED]

    The ID or the Amazon Resource Name (ARN) of the Outpost.

  • Name (string) -- The name of the Outpost.
  • Description (string) -- The description of the Outpost.
  • SupportedHardwareType (string) -- The type of hardware for this Outpost.
Return type

dict

Returns

Response Syntax

{
    'Outpost': {
        'OutpostId': 'string',
        'OwnerId': 'string',
        'OutpostArn': 'string',
        'SiteId': 'string',
        'Name': 'string',
        'Description': 'string',
        'LifeCycleStatus': 'string',
        'AvailabilityZone': 'string',
        'AvailabilityZoneId': 'string',
        'Tags': {
            'string': 'string'
        },
        'SiteArn': 'string',
        'SupportedHardwareType': 'RACK'|'SERVER'
    }
}

Response Structure

  • (dict) --

    • Outpost (dict) --

      Information about an Outpost.

      • OutpostId (string) --

        The ID of the Outpost.

      • OwnerId (string) --

        The Amazon Web Services account ID of the Outpost owner.

      • OutpostArn (string) --

        The Amazon Resource Name (ARN) of the Outpost.

      • SiteId (string) --

        The ID of the site.

      • Name (string) --

        The name of the Outpost.

      • Description (string) --

        The description of the Outpost.

      • LifeCycleStatus (string) --

        The life cycle status.

      • AvailabilityZone (string) --

        The Availability Zone.

      • AvailabilityZoneId (string) --

        The ID of the Availability Zone.

      • Tags (dict) --

        The Outpost tags.

        • (string) --
          • (string) --
      • SiteArn (string) --

        The Amazon Resource Name (ARN) of the site.

      • SupportedHardwareType (string) --

        The hardware type.

Exceptions

update_site(**kwargs)

Updates the site.

See also: AWS API Documentation

Request Syntax

response = client.update_site(
    SiteId='string',
    Name='string',
    Description='string',
    Notes='string'
)
Parameters
  • SiteId (string) --

    [REQUIRED]

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

  • Name (string) -- The name of the site.
  • Description (string) -- The description of the site.
  • Notes (string) -- Notes about a site.
Return type

dict

Returns

Response Syntax

{
    'Site': {
        'SiteId': 'string',
        'AccountId': 'string',
        'Name': 'string',
        'Description': 'string',
        'Tags': {
            'string': 'string'
        },
        'SiteArn': 'string',
        'Notes': 'string',
        'OperatingAddressCountryCode': 'string',
        'OperatingAddressStateOrRegion': 'string',
        'OperatingAddressCity': 'string',
        'RackPhysicalProperties': {
            'PowerDrawKva': 'POWER_5_KVA'|'POWER_10_KVA'|'POWER_15_KVA',
            'PowerPhase': 'SINGLE_PHASE'|'THREE_PHASE',
            'PowerConnector': 'L6_30P'|'IEC309'|'AH530P7W'|'AH532P6W',
            'PowerFeedDrop': 'ABOVE_RACK'|'BELOW_RACK',
            'UplinkGbps': 'UPLINK_1G'|'UPLINK_10G'|'UPLINK_40G'|'UPLINK_100G',
            'UplinkCount': 'UPLINK_COUNT_1'|'UPLINK_COUNT_2'|'UPLINK_COUNT_3'|'UPLINK_COUNT_4'|'UPLINK_COUNT_5'|'UPLINK_COUNT_6'|'UPLINK_COUNT_7'|'UPLINK_COUNT_8'|'UPLINK_COUNT_12'|'UPLINK_COUNT_16',
            'FiberOpticCableType': 'SINGLE_MODE'|'MULTI_MODE',
            'OpticalStandard': 'OPTIC_10GBASE_SR'|'OPTIC_10GBASE_IR'|'OPTIC_10GBASE_LR'|'OPTIC_40GBASE_SR'|'OPTIC_40GBASE_ESR'|'OPTIC_40GBASE_IR4_LR4L'|'OPTIC_40GBASE_LR4'|'OPTIC_100GBASE_SR4'|'OPTIC_100GBASE_CWDM4'|'OPTIC_100GBASE_LR4'|'OPTIC_100G_PSM4_MSA'|'OPTIC_1000BASE_LX'|'OPTIC_1000BASE_SX',
            'MaximumSupportedWeightLbs': 'NO_LIMIT'|'MAX_1400_LBS'|'MAX_1600_LBS'|'MAX_1800_LBS'|'MAX_2000_LBS'
        }
    }
}

Response Structure

  • (dict) --

    • Site (dict) --

      Information about a site.

      • SiteId (string) --

        The ID of the site.

      • AccountId (string) --

        The ID of the Amazon Web Services account.

      • Name (string) --

        The name of the site.

      • Description (string) --

        The description of the site.

      • Tags (dict) --

        The site tags.

        • (string) --
          • (string) --
      • SiteArn (string) --

        The Amazon Resource Name (ARN) of the site.

      • Notes (string) --

        Notes about a site.

      • OperatingAddressCountryCode (string) --

        The ISO-3166 two-letter country code where the hardware is installed and powered on.

      • OperatingAddressStateOrRegion (string) --

        State or region where the hardware is installed and powered on.

      • OperatingAddressCity (string) --

        City where the hardware is installed and powered on.

      • RackPhysicalProperties (dict) --

        Information about the physical and logistical details for a rack at the site.

        • PowerDrawKva (string) --

          The power draw available at the hardware placement position for the rack.

        • PowerPhase (string) --

          The power option that you can provide for hardware.

        • PowerConnector (string) --

          The power connector for the hardware.

        • PowerFeedDrop (string) --

          The position of the power feed.

        • UplinkGbps (string) --

          The uplink speed the rack supports for the connection to the Region.

        • UplinkCount (string) --

          The number of uplinks each Outpost network device.

        • FiberOpticCableType (string) --

          The type of fiber used to attach the Outpost to the network.

        • OpticalStandard (string) --

          The type of optical standard used to attach the Outpost to the 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.

        • MaximumSupportedWeightLbs (string) --

          The maximum rack weight that this site can support. NO_LIMIT is over 2000 lbs (907 kg).

Exceptions

update_site_address(**kwargs)

Updates the site address.

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

You can update the operating address before you place an order at the site, or after all Outposts that belong to the site have been deactivated.

See also: AWS API Documentation

Request Syntax

response = client.update_site_address(
    SiteId='string',
    AddressType='SHIPPING_ADDRESS'|'OPERATING_ADDRESS',
    Address={
        'ContactName': 'string',
        'ContactPhoneNumber': 'string',
        'AddressLine1': 'string',
        'AddressLine2': 'string',
        'AddressLine3': 'string',
        'City': 'string',
        'StateOrRegion': 'string',
        'DistrictOrCounty': 'string',
        'PostalCode': 'string',
        'CountryCode': 'string',
        'Municipality': 'string'
    }
)
Parameters
  • SiteId (string) --

    [REQUIRED]

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

  • AddressType (string) --

    [REQUIRED]

    The type of the address.

  • Address (dict) --

    [REQUIRED]

    The address for the site.

    • ContactName (string) --

      The name of the contact.

    • ContactPhoneNumber (string) --

      The phone number of the contact.

    • AddressLine1 (string) -- [REQUIRED]

      The first line of the address.

    • AddressLine2 (string) --

      The second line of the address.

    • AddressLine3 (string) --

      The third line of the address.

    • City (string) -- [REQUIRED]

      The city for the address.

    • StateOrRegion (string) -- [REQUIRED]

      The state for the address.

    • DistrictOrCounty (string) --

      The district or county for the address.

    • PostalCode (string) -- [REQUIRED]

      The postal code for the address.

    • CountryCode (string) -- [REQUIRED]

      The ISO-3166 two-letter country code for the address.

    • Municipality (string) --

      The municipality for the address.

Return type

dict

Returns

Response Syntax

{
    'AddressType': 'SHIPPING_ADDRESS'|'OPERATING_ADDRESS',
    'Address': {
        'ContactName': 'string',
        'ContactPhoneNumber': 'string',
        'AddressLine1': 'string',
        'AddressLine2': 'string',
        'AddressLine3': 'string',
        'City': 'string',
        'StateOrRegion': 'string',
        'DistrictOrCounty': 'string',
        'PostalCode': 'string',
        'CountryCode': 'string',
        'Municipality': 'string'
    }
}

Response Structure

  • (dict) --

    • AddressType (string) --

      The type of the address.

    • Address (dict) --

      Information about an address.

      • ContactName (string) --

        The name of the contact.

      • ContactPhoneNumber (string) --

        The phone number of the contact.

      • AddressLine1 (string) --

        The first line of the address.

      • AddressLine2 (string) --

        The second line of the address.

      • AddressLine3 (string) --

        The third line of the address.

      • City (string) --

        The city for the address.

      • StateOrRegion (string) --

        The state for the address.

      • DistrictOrCounty (string) --

        The district or county for the address.

      • PostalCode (string) --

        The postal code for the address.

      • CountryCode (string) --

        The ISO-3166 two-letter country code for the address.

      • Municipality (string) --

        The municipality for the address.

Exceptions

update_site_rack_physical_properties(**kwargs)

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.

See also: AWS API Documentation

Request Syntax

response = client.update_site_rack_physical_properties(
    SiteId='string',
    PowerDrawKva='POWER_5_KVA'|'POWER_10_KVA'|'POWER_15_KVA',
    PowerPhase='SINGLE_PHASE'|'THREE_PHASE',
    PowerConnector='L6_30P'|'IEC309'|'AH530P7W'|'AH532P6W',
    PowerFeedDrop='ABOVE_RACK'|'BELOW_RACK',
    UplinkGbps='UPLINK_1G'|'UPLINK_10G'|'UPLINK_40G'|'UPLINK_100G',
    UplinkCount='UPLINK_COUNT_1'|'UPLINK_COUNT_2'|'UPLINK_COUNT_3'|'UPLINK_COUNT_4'|'UPLINK_COUNT_5'|'UPLINK_COUNT_6'|'UPLINK_COUNT_7'|'UPLINK_COUNT_8'|'UPLINK_COUNT_12'|'UPLINK_COUNT_16',
    FiberOpticCableType='SINGLE_MODE'|'MULTI_MODE',
    OpticalStandard='OPTIC_10GBASE_SR'|'OPTIC_10GBASE_IR'|'OPTIC_10GBASE_LR'|'OPTIC_40GBASE_SR'|'OPTIC_40GBASE_ESR'|'OPTIC_40GBASE_IR4_LR4L'|'OPTIC_40GBASE_LR4'|'OPTIC_100GBASE_SR4'|'OPTIC_100GBASE_CWDM4'|'OPTIC_100GBASE_LR4'|'OPTIC_100G_PSM4_MSA'|'OPTIC_1000BASE_LX'|'OPTIC_1000BASE_SX',
    MaximumSupportedWeightLbs='NO_LIMIT'|'MAX_1400_LBS'|'MAX_1600_LBS'|'MAX_1800_LBS'|'MAX_2000_LBS'
)
Parameters
  • SiteId (string) --

    [REQUIRED]

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

  • PowerDrawKva (string) -- Specify in kVA the power draw available at the hardware placement position for the rack.
  • PowerPhase (string) --

    Specify 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
  • PowerConnector (string) --

    Specify 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
  • PowerFeedDrop (string) -- Specify whether the power feed comes above or below the rack.
  • UplinkGbps (string) -- Specify the uplink speed the rack should support for the connection to the Region.
  • UplinkCount (string) --

    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
  • FiberOpticCableType (string) -- Specify the type of fiber that you will use to attach the Outpost to your network.
  • OpticalStandard (string) --

    Specify 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
  • MaximumSupportedWeightLbs (string) -- Specify the maximum rack weight that this site can support. NO_LIMIT is over 2000lbs.
Return type

dict

Returns

Response Syntax

{
    'Site': {
        'SiteId': 'string',
        'AccountId': 'string',
        'Name': 'string',
        'Description': 'string',
        'Tags': {
            'string': 'string'
        },
        'SiteArn': 'string',
        'Notes': 'string',
        'OperatingAddressCountryCode': 'string',
        'OperatingAddressStateOrRegion': 'string',
        'OperatingAddressCity': 'string',
        'RackPhysicalProperties': {
            'PowerDrawKva': 'POWER_5_KVA'|'POWER_10_KVA'|'POWER_15_KVA',
            'PowerPhase': 'SINGLE_PHASE'|'THREE_PHASE',
            'PowerConnector': 'L6_30P'|'IEC309'|'AH530P7W'|'AH532P6W',
            'PowerFeedDrop': 'ABOVE_RACK'|'BELOW_RACK',
            'UplinkGbps': 'UPLINK_1G'|'UPLINK_10G'|'UPLINK_40G'|'UPLINK_100G',
            'UplinkCount': 'UPLINK_COUNT_1'|'UPLINK_COUNT_2'|'UPLINK_COUNT_3'|'UPLINK_COUNT_4'|'UPLINK_COUNT_5'|'UPLINK_COUNT_6'|'UPLINK_COUNT_7'|'UPLINK_COUNT_8'|'UPLINK_COUNT_12'|'UPLINK_COUNT_16',
            'FiberOpticCableType': 'SINGLE_MODE'|'MULTI_MODE',
            'OpticalStandard': 'OPTIC_10GBASE_SR'|'OPTIC_10GBASE_IR'|'OPTIC_10GBASE_LR'|'OPTIC_40GBASE_SR'|'OPTIC_40GBASE_ESR'|'OPTIC_40GBASE_IR4_LR4L'|'OPTIC_40GBASE_LR4'|'OPTIC_100GBASE_SR4'|'OPTIC_100GBASE_CWDM4'|'OPTIC_100GBASE_LR4'|'OPTIC_100G_PSM4_MSA'|'OPTIC_1000BASE_LX'|'OPTIC_1000BASE_SX',
            'MaximumSupportedWeightLbs': 'NO_LIMIT'|'MAX_1400_LBS'|'MAX_1600_LBS'|'MAX_1800_LBS'|'MAX_2000_LBS'
        }
    }
}

Response Structure

  • (dict) --

    • Site (dict) --

      Information about a site.

      • SiteId (string) --

        The ID of the site.

      • AccountId (string) --

        The ID of the Amazon Web Services account.

      • Name (string) --

        The name of the site.

      • Description (string) --

        The description of the site.

      • Tags (dict) --

        The site tags.

        • (string) --
          • (string) --
      • SiteArn (string) --

        The Amazon Resource Name (ARN) of the site.

      • Notes (string) --

        Notes about a site.

      • OperatingAddressCountryCode (string) --

        The ISO-3166 two-letter country code where the hardware is installed and powered on.

      • OperatingAddressStateOrRegion (string) --

        State or region where the hardware is installed and powered on.

      • OperatingAddressCity (string) --

        City where the hardware is installed and powered on.

      • RackPhysicalProperties (dict) --

        Information about the physical and logistical details for a rack at the site.

        • PowerDrawKva (string) --

          The power draw available at the hardware placement position for the rack.

        • PowerPhase (string) --

          The power option that you can provide for hardware.

        • PowerConnector (string) --

          The power connector for the hardware.

        • PowerFeedDrop (string) --

          The position of the power feed.

        • UplinkGbps (string) --

          The uplink speed the rack supports for the connection to the Region.

        • UplinkCount (string) --

          The number of uplinks each Outpost network device.

        • FiberOpticCableType (string) --

          The type of fiber used to attach the Outpost to the network.

        • OpticalStandard (string) --

          The type of optical standard used to attach the Outpost to the 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.

        • MaximumSupportedWeightLbs (string) --

          The maximum rack weight that this site can support. NO_LIMIT is over 2000 lbs (907 kg).

Exceptions

Client Exceptions

Client exceptions are available on a client instance via the exceptions property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.

The available client exceptions are:

class Outposts.Client.exceptions.AccessDeniedException

You do not have permission to perform this operation.

Example

try:
  ...
except client.exceptions.AccessDeniedException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    You do not have permission to perform this operation.

    • Message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Outposts.Client.exceptions.ConflictException

Updating or deleting this resource can cause an inconsistent state.

Example

try:
  ...
except client.exceptions.ConflictException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'Message': 'string',
    'ResourceId': 'string',
    'ResourceType': 'OUTPOST'|'ORDER',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    Updating or deleting this resource can cause an inconsistent state.

    • Message (string) --

    • ResourceId (string) --

      The ID of the resource causing the conflict.

    • ResourceType (string) --

      The type of the resource causing the conflict.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Outposts.Client.exceptions.InternalServerException

An internal error has occurred.

Example

try:
  ...
except client.exceptions.InternalServerException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    An internal error has occurred.

    • Message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Outposts.Client.exceptions.NotFoundException

The specified request is not valid.

Example

try:
  ...
except client.exceptions.NotFoundException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    The specified request is not valid.

    • Message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Outposts.Client.exceptions.ServiceQuotaExceededException

You have exceeded a service quota.

Example

try:
  ...
except client.exceptions.ServiceQuotaExceededException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    You have exceeded a service quota.

    • Message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Outposts.Client.exceptions.ValidationException

A parameter is not valid.

Example

try:
  ...
except client.exceptions.ValidationException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'Message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    A parameter is not valid.

    • Message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.

Paginators

The available paginators are: