Class: Aws::Transfer::Types::DescribedServer

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb

Overview

Describes the properties of a file transfer protocol-enabled server that was specified.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#arnString

Specifies the unique Amazon Resource Name (ARN) of the server.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#certificateString

Specifies the ARN of the Amazon Web ServicesCertificate Manager (ACM) certificate. Required when Protocols is set to FTPS.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#domainString

Specifies the domain of the storage system that is used for file transfers.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#endpoint_detailsTypes::EndpointDetails

The virtual private cloud (VPC) endpoint settings that are configured for your server. When you host your endpoint within your VPC, you can make it accessible only to resources within your VPC, or you can attach Elastic IP addresses and make it accessible to clients over the internet. Your VPC's default security groups are automatically assigned to your endpoint.



1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#endpoint_typeString

Defines the type of endpoint that your server is connected to. If your server is connected to a VPC endpoint, your server isn't accessible over the public internet.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#host_key_fingerprintString

Specifies the Base64-encoded SHA256 fingerprint of the server's host key. This value is equivalent to the output of the ssh-keygen -l -f my-new-server-key command.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#identity_provider_detailsTypes::IdentityProviderDetails

Specifies information to call a customer-supplied authentication API. This field is not populated when the IdentityProviderType of a server is AWS_DIRECTORY_SERVICE or SERVICE_MANAGED.



1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#identity_provider_typeString

Specifies the mode of authentication for a server. The default value is SERVICE_MANAGED, which allows you to store and access user credentials within the Amazon Web Services Transfer Family service.

Use AWS_DIRECTORY_SERVICE to provide access to Active Directory groups in Amazon Web Services Managed Active Directory or Microsoft Active Directory in your on-premises environment or in Amazon Web Services using AD Connectors. This option also requires you to provide a Directory ID using the IdentityProviderDetails parameter.

Use the API_GATEWAY value to integrate with an identity provider of your choosing. The API_GATEWAY setting requires you to provide an API Gateway endpoint URL to call for authentication using the IdentityProviderDetails parameter.

Use the AWS_LAMBDA value to directly use a Lambda function as your identity provider. If you choose this value, you must specify the ARN for the lambda function in the Function parameter for the IdentityProviderDetails data type.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#logging_roleString

Specifies the Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFS events. When set, user activity can be viewed in your CloudWatch logs.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#protocol_detailsTypes::ProtocolDetails

The protocol settings that are configured for your server.

Use the PassiveIp parameter to indicate passive mode. Enter a single dotted-quad IPv4 address, such as the external IP address of a firewall, router, or load balancer.



1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#protocolsArray<String>

Specifies the file transfer protocol or protocols over which your file transfer protocol client can connect to your server's endpoint. The available protocols are:

  • SFTP (Secure Shell (SSH) File Transfer Protocol): File transfer over SSH

  • FTPS (File Transfer Protocol Secure): File transfer with TLS encryption

  • FTP (File Transfer Protocol): Unencrypted file transfer

Returns:

  • (Array<String>)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#security_policy_nameString

Specifies the name of the security policy that is attached to the server.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#server_idString

Specifies the unique system-assigned identifier for a server that you instantiate.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#stateString

Specifies the condition of a server for the server that was described. A value of ONLINE indicates that the server can accept jobs and transfer files. A State value of OFFLINE means that the server cannot perform file transfer operations.

The states of STARTING and STOPPING indicate that the server is in an intermediate state, either not fully able to respond, or not fully offline. The values of START_FAILED or STOP_FAILED can indicate an error condition.

Returns:

  • (String)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#tagsArray<Types::Tag>

Specifies the key-value pairs that you can use to search for and group servers that were assigned to the server that was described.

Returns:



1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#user_countInteger

Specifies the number of users that are assigned to a server you specified with the ServerId.

Returns:

  • (Integer)


1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end

#workflow_detailsTypes::WorkflowDetails

Specifies the workflow ID for the workflow to assign and the execution role used for executing the workflow.



1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 1682

class DescribedServer < Struct.new(
  :arn,
  :certificate,
  :protocol_details,
  :domain,
  :endpoint_details,
  :endpoint_type,
  :host_key_fingerprint,
  :identity_provider_details,
  :identity_provider_type,
  :logging_role,
  :protocols,
  :security_policy_name,
  :server_id,
  :state,
  :tags,
  :user_count,
  :workflow_details)
  SENSITIVE = []
  include Aws::Structure
end