pub struct Client { /* private fields */ }
Expand description
Client for AWS Directory Service
Client for invoking operations on AWS Directory Service. Each operation on AWS Directory Service is a method on this
this struct. .send()
MUST be invoked on the generated operations to dispatch the request to the service.
§Constructing a Client
A Config
is required to construct a client. For most use cases, the aws-config
crate should be used to automatically resolve this config using
aws_config::load_from_env()
, since this will resolve an SdkConfig
which can be shared
across multiple different AWS SDK clients. This config resolution process can be customized
by calling aws_config::from_env()
instead, which returns a ConfigLoader
that uses
the builder pattern to customize the default config.
In the simplest case, creating a client looks as follows:
let config = aws_config::load_from_env().await;
let client = aws_sdk_directory::Client::new(&config);
Occasionally, SDKs may have additional service-specific values that can be set on the Config
that
is absent from SdkConfig
, or slightly different settings for a specific client may be desired.
The Builder
struct implements From<&SdkConfig>
, so setting these specific settings can be
done as follows:
let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_directory::config::Builder::from(&sdk_config)
.some_service_specific_setting("value")
.build();
See the aws-config
docs and Config
for more information on customizing configuration.
Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.
§Using the Client
A client has a function for every operation that can be performed by the service.
For example, the AcceptSharedDirectory
operation has
a Client::accept_shared_directory
, function which returns a builder for that operation.
The fluent builder ultimately has a send()
function that returns an async future that
returns a result, as illustrated below:
let result = client.accept_shared_directory()
.shared_directory_id("example")
.send()
.await;
The underlying HTTP requests that get made by this can be modified with the customize_operation
function on the fluent builder. See the customize
module for more
information.
Implementations§
Source§impl Client
impl Client
Constructs a fluent builder for the AcceptSharedDirectory
operation.
- The fluent builder is configurable:
shared_directory_id(impl Into<String>)
/set_shared_directory_id(Option<String>)
:
required: trueIdentifier of the shared directory in the directory consumer account. This identifier is different for each directory owner account.
- On success, responds with
AcceptSharedDirectoryOutput
with field(s):shared_directory(Option<SharedDirectory>)
:The shared directory in the directory consumer account.
- On failure, responds with
SdkError<AcceptSharedDirectoryError>
Source§impl Client
impl Client
Sourcepub fn add_ip_routes(&self) -> AddIpRoutesFluentBuilder
pub fn add_ip_routes(&self) -> AddIpRoutesFluentBuilder
Constructs a fluent builder for the AddIpRoutes
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier (ID) of the directory to which to add the address block.
ip_routes(IpRoute)
/set_ip_routes(Option<Vec::<IpRoute>>)
:
required: trueIP address blocks, using CIDR format, of the traffic to route. This is often the IP address block of the DNS server used for your self-managed domain.
update_security_group_for_directory_controllers(bool)
/set_update_security_group_for_directory_controllers(Option<bool>)
:
required: falseIf set to true, updates the inbound and outbound rules of the security group that has the description: “Amazon Web Services created security group for directory ID directory controllers.” Following are the new rules:
Inbound:
-
Type: Custom UDP Rule, Protocol: UDP, Range: 88, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom UDP Rule, Protocol: UDP, Range: 123, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom UDP Rule, Protocol: UDP, Range: 138, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom UDP Rule, Protocol: UDP, Range: 389, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom UDP Rule, Protocol: UDP, Range: 464, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom UDP Rule, Protocol: UDP, Range: 445, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom TCP Rule, Protocol: TCP, Range: 88, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom TCP Rule, Protocol: TCP, Range: 135, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom TCP Rule, Protocol: TCP, Range: 445, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom TCP Rule, Protocol: TCP, Range: 464, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom TCP Rule, Protocol: TCP, Range: 636, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom TCP Rule, Protocol: TCP, Range: 1024-65535, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: Custom TCP Rule, Protocol: TCP, Range: 3268-33269, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: DNS (UDP), Protocol: UDP, Range: 53, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: DNS (TCP), Protocol: TCP, Range: 53, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: LDAP, Protocol: TCP, Range: 389, Source: Managed Microsoft AD VPC IPv4 CIDR
-
Type: All ICMP, Protocol: All, Range: N/A, Source: Managed Microsoft AD VPC IPv4 CIDR
Outbound:
-
Type: All traffic, Protocol: All, Range: All, Destination: 0.0.0.0/0
These security rules impact an internal network interface that is not exposed publicly.
-
- On success, responds with
AddIpRoutesOutput
- On failure, responds with
SdkError<AddIpRoutesError>
Source§impl Client
impl Client
Sourcepub fn add_region(&self) -> AddRegionFluentBuilder
pub fn add_region(&self) -> AddRegionFluentBuilder
Constructs a fluent builder for the AddRegion
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory to which you want to add Region replication.
region_name(impl Into<String>)
/set_region_name(Option<String>)
:
required: trueThe name of the Region where you want to add domain controllers for replication. For example,
us-east-1
.vpc_settings(DirectoryVpcSettings)
/set_vpc_settings(Option<DirectoryVpcSettings>)
:
required: trueContains VPC information for the
CreateDirectory
orCreateMicrosoftAD
operation.
- On success, responds with
AddRegionOutput
- On failure, responds with
SdkError<AddRegionError>
Source§impl Client
impl Client
Constructs a fluent builder for the AddTagsToResource
operation.
- The fluent builder is configurable:
resource_id(impl Into<String>)
/set_resource_id(Option<String>)
:
required: trueIdentifier (ID) for the directory to which to add the tag.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: trueThe tags to be assigned to the directory.
- On success, responds with
AddTagsToResourceOutput
- On failure, responds with
SdkError<AddTagsToResourceError>
Source§impl Client
impl Client
Sourcepub fn cancel_schema_extension(&self) -> CancelSchemaExtensionFluentBuilder
pub fn cancel_schema_extension(&self) -> CancelSchemaExtensionFluentBuilder
Constructs a fluent builder for the CancelSchemaExtension
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory whose schema extension will be canceled.
schema_extension_id(impl Into<String>)
/set_schema_extension_id(Option<String>)
:
required: trueThe identifier of the schema extension that will be canceled.
- On success, responds with
CancelSchemaExtensionOutput
- On failure, responds with
SdkError<CancelSchemaExtensionError>
Source§impl Client
impl Client
Sourcepub fn connect_directory(&self) -> ConnectDirectoryFluentBuilder
pub fn connect_directory(&self) -> ConnectDirectoryFluentBuilder
Constructs a fluent builder for the ConnectDirectory
operation.
- The fluent builder is configurable:
name(impl Into<String>)
/set_name(Option<String>)
:
required: trueThe fully qualified name of your self-managed directory, such as
corp.example.com
.short_name(impl Into<String>)
/set_short_name(Option<String>)
:
required: falseThe NetBIOS name of your self-managed directory, such as
CORP
.password(impl Into<String>)
/set_password(Option<String>)
:
required: trueThe password for your self-managed user account.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description for the directory.
size(DirectorySize)
/set_size(Option<DirectorySize>)
:
required: trueThe size of the directory.
connect_settings(DirectoryConnectSettings)
/set_connect_settings(Option<DirectoryConnectSettings>)
:
required: trueA
DirectoryConnectSettings
object that contains additional information for the operation.tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseThe tags to be assigned to AD Connector.
- On success, responds with
ConnectDirectoryOutput
with field(s):directory_id(Option<String>)
:The identifier of the new directory.
- On failure, responds with
SdkError<ConnectDirectoryError>
Source§impl Client
impl Client
Sourcepub fn create_alias(&self) -> CreateAliasFluentBuilder
pub fn create_alias(&self) -> CreateAliasFluentBuilder
Constructs a fluent builder for the CreateAlias
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to create the alias.
alias(impl Into<String>)
/set_alias(Option<String>)
:
required: trueThe requested alias.
The alias must be unique amongst all aliases in Amazon Web Services. This operation throws an
EntityAlreadyExistsException
error if the alias already exists.
- On success, responds with
CreateAliasOutput
with field(s):directory_id(Option<String>)
:The identifier of the directory.
alias(Option<String>)
:The alias for the directory.
- On failure, responds with
SdkError<CreateAliasError>
Source§impl Client
impl Client
Sourcepub fn create_computer(&self) -> CreateComputerFluentBuilder
pub fn create_computer(&self) -> CreateComputerFluentBuilder
Constructs a fluent builder for the CreateComputer
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory in which to create the computer account.
computer_name(impl Into<String>)
/set_computer_name(Option<String>)
:
required: trueThe name of the computer account.
password(impl Into<String>)
/set_password(Option<String>)
:
required: trueA one-time password that is used to join the computer to the directory. You should generate a random, strong password to use for this parameter.
organizational_unit_distinguished_name(impl Into<String>)
/set_organizational_unit_distinguished_name(Option<String>)
:
required: falseThe fully-qualified distinguished name of the organizational unit to place the computer account in.
computer_attributes(Attribute)
/set_computer_attributes(Option<Vec::<Attribute>>)
:
required: falseAn array of
Attribute
objects that contain any LDAP attributes to apply to the computer account.
- On success, responds with
CreateComputerOutput
with field(s):computer(Option<Computer>)
:A
Computer
object that represents the computer account.
- On failure, responds with
SdkError<CreateComputerError>
Source§impl Client
impl Client
Sourcepub fn create_conditional_forwarder(
&self,
) -> CreateConditionalForwarderFluentBuilder
pub fn create_conditional_forwarder( &self, ) -> CreateConditionalForwarderFluentBuilder
Constructs a fluent builder for the CreateConditionalForwarder
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe directory ID of the Amazon Web Services directory for which you are creating the conditional forwarder.
remote_domain_name(impl Into<String>)
/set_remote_domain_name(Option<String>)
:
required: trueThe fully qualified domain name (FQDN) of the remote domain with which you will set up a trust relationship.
dns_ip_addrs(impl Into<String>)
/set_dns_ip_addrs(Option<Vec::<String>>)
:
required: trueThe IP addresses of the remote DNS server associated with RemoteDomainName.
- On success, responds with
CreateConditionalForwarderOutput
- On failure, responds with
SdkError<CreateConditionalForwarderError>
Source§impl Client
impl Client
Sourcepub fn create_directory(&self) -> CreateDirectoryFluentBuilder
pub fn create_directory(&self) -> CreateDirectoryFluentBuilder
Constructs a fluent builder for the CreateDirectory
operation.
- The fluent builder is configurable:
name(impl Into<String>)
/set_name(Option<String>)
:
required: trueThe fully qualified name for the directory, such as
corp.example.com
.short_name(impl Into<String>)
/set_short_name(Option<String>)
:
required: falseThe NetBIOS name of the directory, such as
CORP
.password(impl Into<String>)
/set_password(Option<String>)
:
required: trueThe password for the directory administrator. The directory creation process creates a directory administrator account with the user name
Administrator
and this password.If you need to change the password for the administrator account, you can use the
ResetUserPassword
API call.The regex pattern for this string is made up of the following conditions:
-
Length (?=^.{8,64}$) – Must be between 8 and 64 characters
AND any 3 of the following password complexity rules required by Active Directory:
-
Numbers and upper case and lowercase (?=.\d)(?=.[A-Z])(?=.[a-z])
-
Numbers and special characters and lower case (?=.\d)(?=.[^A-Za-z0-9\s])(?=.[a-z])
-
Special characters and upper case and lower case (?=.[^A-Za-z0-9\s])(?=.[A-Z])(?=.[a-z])
-
Numbers and upper case and special characters (?=.\d)(?=.[A-Z])(?=.[^A-Za-z0-9\s])
For additional information about how Active Directory passwords are enforced, see Password must meet complexity requirements on the Microsoft website.
-
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description for the directory.
size(DirectorySize)
/set_size(Option<DirectorySize>)
:
required: trueThe size of the directory.
vpc_settings(DirectoryVpcSettings)
/set_vpc_settings(Option<DirectoryVpcSettings>)
:
required: falseA
DirectoryVpcSettings
object that contains additional information for the operation.tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseThe tags to be assigned to the Simple AD directory.
- On success, responds with
CreateDirectoryOutput
with field(s):directory_id(Option<String>)
:The identifier of the directory that was created.
- On failure, responds with
SdkError<CreateDirectoryError>
Source§impl Client
impl Client
Sourcepub fn create_log_subscription(&self) -> CreateLogSubscriptionFluentBuilder
pub fn create_log_subscription(&self) -> CreateLogSubscriptionFluentBuilder
Constructs a fluent builder for the CreateLogSubscription
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier of the directory to which you want to subscribe and receive real-time logs to your specified CloudWatch log group.
log_group_name(impl Into<String>)
/set_log_group_name(Option<String>)
:
required: trueThe name of the CloudWatch log group where the real-time domain controller logs are forwarded.
- On success, responds with
CreateLogSubscriptionOutput
- On failure, responds with
SdkError<CreateLogSubscriptionError>
Source§impl Client
impl Client
Sourcepub fn create_microsoft_ad(&self) -> CreateMicrosoftADFluentBuilder
pub fn create_microsoft_ad(&self) -> CreateMicrosoftADFluentBuilder
Constructs a fluent builder for the CreateMicrosoftAD
operation.
- The fluent builder is configurable:
name(impl Into<String>)
/set_name(Option<String>)
:
required: trueThe fully qualified domain name for the Managed Microsoft AD directory, such as
corp.example.com
. This name will resolve inside your VPC only. It does not need to be publicly resolvable.short_name(impl Into<String>)
/set_short_name(Option<String>)
:
required: falseThe NetBIOS name for your domain, such as
CORP
. If you don’t specify a NetBIOS name, it will default to the first part of your directory DNS. For example,CORP
for the directory DNScorp.example.com
.password(impl Into<String>)
/set_password(Option<String>)
:
required: trueThe password for the default administrative user named
Admin
.If you need to change the password for the administrator account, you can use the
ResetUserPassword
API call.description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description for the directory. This label will appear on the Amazon Web Services console
Directory Details
page after the directory is created.vpc_settings(DirectoryVpcSettings)
/set_vpc_settings(Option<DirectoryVpcSettings>)
:
required: trueContains VPC information for the
CreateDirectory
orCreateMicrosoftAD
operation.edition(DirectoryEdition)
/set_edition(Option<DirectoryEdition>)
:
required: falseManaged Microsoft AD is available in two editions:
Standard
andEnterprise
.Enterprise
is the default.tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseThe tags to be assigned to the Managed Microsoft AD directory.
- On success, responds with
CreateMicrosoftAdOutput
with field(s):directory_id(Option<String>)
:The identifier of the directory that was created.
- On failure, responds with
SdkError<CreateMicrosoftADError>
Source§impl Client
impl Client
Sourcepub fn create_snapshot(&self) -> CreateSnapshotFluentBuilder
pub fn create_snapshot(&self) -> CreateSnapshotFluentBuilder
Constructs a fluent builder for the CreateSnapshot
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory of which to take a snapshot.
name(impl Into<String>)
/set_name(Option<String>)
:
required: falseThe descriptive name to apply to the snapshot.
- On success, responds with
CreateSnapshotOutput
with field(s):snapshot_id(Option<String>)
:The identifier of the snapshot that was created.
- On failure, responds with
SdkError<CreateSnapshotError>
Source§impl Client
impl Client
Sourcepub fn create_trust(&self) -> CreateTrustFluentBuilder
pub fn create_trust(&self) -> CreateTrustFluentBuilder
Constructs a fluent builder for the CreateTrust
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe Directory ID of the Managed Microsoft AD directory for which to establish the trust relationship.
remote_domain_name(impl Into<String>)
/set_remote_domain_name(Option<String>)
:
required: trueThe Fully Qualified Domain Name (FQDN) of the external domain for which to create the trust relationship.
trust_password(impl Into<String>)
/set_trust_password(Option<String>)
:
required: trueThe trust password. The trust password must be the same password that was used when creating the trust relationship on the external domain.
trust_direction(TrustDirection)
/set_trust_direction(Option<TrustDirection>)
:
required: trueThe direction of the trust relationship.
trust_type(TrustType)
/set_trust_type(Option<TrustType>)
:
required: falseThe trust relationship type.
Forest
is the default.conditional_forwarder_ip_addrs(impl Into<String>)
/set_conditional_forwarder_ip_addrs(Option<Vec::<String>>)
:
required: falseThe IP addresses of the remote DNS server associated with RemoteDomainName.
selective_auth(SelectiveAuth)
/set_selective_auth(Option<SelectiveAuth>)
:
required: falseOptional parameter to enable selective authentication for the trust.
- On success, responds with
CreateTrustOutput
with field(s):trust_id(Option<String>)
:A unique identifier for the trust relationship that was created.
- On failure, responds with
SdkError<CreateTrustError>
Source§impl Client
impl Client
Sourcepub fn delete_conditional_forwarder(
&self,
) -> DeleteConditionalForwarderFluentBuilder
pub fn delete_conditional_forwarder( &self, ) -> DeleteConditionalForwarderFluentBuilder
Constructs a fluent builder for the DeleteConditionalForwarder
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe directory ID for which you are deleting the conditional forwarder.
remote_domain_name(impl Into<String>)
/set_remote_domain_name(Option<String>)
:
required: trueThe fully qualified domain name (FQDN) of the remote domain with which you are deleting the conditional forwarder.
- On success, responds with
DeleteConditionalForwarderOutput
- On failure, responds with
SdkError<DeleteConditionalForwarderError>
Source§impl Client
impl Client
Sourcepub fn delete_directory(&self) -> DeleteDirectoryFluentBuilder
pub fn delete_directory(&self) -> DeleteDirectoryFluentBuilder
Constructs a fluent builder for the DeleteDirectory
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory to delete.
- On success, responds with
DeleteDirectoryOutput
with field(s):directory_id(Option<String>)
:The directory identifier.
- On failure, responds with
SdkError<DeleteDirectoryError>
Source§impl Client
impl Client
Sourcepub fn delete_log_subscription(&self) -> DeleteLogSubscriptionFluentBuilder
pub fn delete_log_subscription(&self) -> DeleteLogSubscriptionFluentBuilder
Constructs a fluent builder for the DeleteLogSubscription
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier of the directory whose log subscription you want to delete.
- On success, responds with
DeleteLogSubscriptionOutput
- On failure, responds with
SdkError<DeleteLogSubscriptionError>
Source§impl Client
impl Client
Sourcepub fn delete_snapshot(&self) -> DeleteSnapshotFluentBuilder
pub fn delete_snapshot(&self) -> DeleteSnapshotFluentBuilder
Constructs a fluent builder for the DeleteSnapshot
operation.
- The fluent builder is configurable:
snapshot_id(impl Into<String>)
/set_snapshot_id(Option<String>)
:
required: trueThe identifier of the directory snapshot to be deleted.
- On success, responds with
DeleteSnapshotOutput
with field(s):snapshot_id(Option<String>)
:The identifier of the directory snapshot that was deleted.
- On failure, responds with
SdkError<DeleteSnapshotError>
Source§impl Client
impl Client
Sourcepub fn delete_trust(&self) -> DeleteTrustFluentBuilder
pub fn delete_trust(&self) -> DeleteTrustFluentBuilder
Constructs a fluent builder for the DeleteTrust
operation.
- The fluent builder is configurable:
trust_id(impl Into<String>)
/set_trust_id(Option<String>)
:
required: trueThe Trust ID of the trust relationship to be deleted.
delete_associated_conditional_forwarder(bool)
/set_delete_associated_conditional_forwarder(Option<bool>)
:
required: falseDelete a conditional forwarder as part of a DeleteTrustRequest.
- On success, responds with
DeleteTrustOutput
with field(s):trust_id(Option<String>)
:The Trust ID of the trust relationship that was deleted.
- On failure, responds with
SdkError<DeleteTrustError>
Source§impl Client
impl Client
Sourcepub fn deregister_certificate(&self) -> DeregisterCertificateFluentBuilder
pub fn deregister_certificate(&self) -> DeregisterCertificateFluentBuilder
Constructs a fluent builder for the DeregisterCertificate
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory.
certificate_id(impl Into<String>)
/set_certificate_id(Option<String>)
:
required: trueThe identifier of the certificate.
- On success, responds with
DeregisterCertificateOutput
- On failure, responds with
SdkError<DeregisterCertificateError>
Source§impl Client
impl Client
Sourcepub fn deregister_event_topic(&self) -> DeregisterEventTopicFluentBuilder
pub fn deregister_event_topic(&self) -> DeregisterEventTopicFluentBuilder
Constructs a fluent builder for the DeregisterEventTopic
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe Directory ID to remove as a publisher. This directory will no longer send messages to the specified Amazon SNS topic.
topic_name(impl Into<String>)
/set_topic_name(Option<String>)
:
required: trueThe name of the Amazon SNS topic from which to remove the directory as a publisher.
- On success, responds with
DeregisterEventTopicOutput
- On failure, responds with
SdkError<DeregisterEventTopicError>
Source§impl Client
impl Client
Sourcepub fn describe_certificate(&self) -> DescribeCertificateFluentBuilder
pub fn describe_certificate(&self) -> DescribeCertificateFluentBuilder
Constructs a fluent builder for the DescribeCertificate
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory.
certificate_id(impl Into<String>)
/set_certificate_id(Option<String>)
:
required: trueThe identifier of the certificate.
- On success, responds with
DescribeCertificateOutput
with field(s):certificate(Option<Certificate>)
:Information about the certificate, including registered date time, certificate state, the reason for the state, expiration date time, and certificate common name.
- On failure, responds with
SdkError<DescribeCertificateError>
Source§impl Client
impl Client
Sourcepub fn describe_client_authentication_settings(
&self,
) -> DescribeClientAuthenticationSettingsFluentBuilder
pub fn describe_client_authentication_settings( &self, ) -> DescribeClientAuthenticationSettingsFluentBuilder
Constructs a fluent builder for the DescribeClientAuthenticationSettings
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to retrieve information.
r#type(ClientAuthenticationType)
/set_type(Option<ClientAuthenticationType>)
:
required: falseThe type of client authentication for which to retrieve information. If no type is specified, a list of all client authentication types that are supported for the specified directory is retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe DescribeClientAuthenticationSettingsResult.NextToken value from a previous call to
DescribeClientAuthenticationSettings
. Pass null if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of items to return. If this value is zero, the maximum number of items is specified by the limitations of the operation.
- On success, responds with
DescribeClientAuthenticationSettingsOutput
with field(s):client_authentication_settings_info(Option<Vec::<ClientAuthenticationSettingInfo>>)
:Information about the type of client authentication for the specified directory. The following information is retrieved: The date and time when the status of the client authentication type was last updated, whether the client authentication type is enabled or disabled, and the type of client authentication.
next_token(Option<String>)
:The next token used to retrieve the client authentication settings if the number of setting types exceeds page limit and there is another page.
- On failure, responds with
SdkError<DescribeClientAuthenticationSettingsError>
Source§impl Client
impl Client
Sourcepub fn describe_conditional_forwarders(
&self,
) -> DescribeConditionalForwardersFluentBuilder
pub fn describe_conditional_forwarders( &self, ) -> DescribeConditionalForwardersFluentBuilder
Constructs a fluent builder for the DescribeConditionalForwarders
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe directory ID for which to get the list of associated conditional forwarders.
remote_domain_names(impl Into<String>)
/set_remote_domain_names(Option<Vec::<String>>)
:
required: falseThe fully qualified domain names (FQDN) of the remote domains for which to get the list of associated conditional forwarders. If this member is null, all conditional forwarders are returned.
- On success, responds with
DescribeConditionalForwardersOutput
with field(s):conditional_forwarders(Option<Vec::<ConditionalForwarder>>)
:The list of conditional forwarders that have been created.
- On failure, responds with
SdkError<DescribeConditionalForwardersError>
Source§impl Client
impl Client
Sourcepub fn describe_directories(&self) -> DescribeDirectoriesFluentBuilder
pub fn describe_directories(&self) -> DescribeDirectoriesFluentBuilder
Constructs a fluent builder for the DescribeDirectories
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_ids(impl Into<String>)
/set_directory_ids(Option<Vec::<String>>)
:
required: falseA list of identifiers of the directories for which to obtain the information. If this member is null, all directories that belong to the current account are returned.
An empty list results in an
InvalidParameterException
being thrown.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe
DescribeDirectoriesResult.NextToken
value from a previous call toDescribeDirectories
. Pass null if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of items to return. If this value is zero, the maximum number of items is specified by the limitations of the operation.
- On success, responds with
DescribeDirectoriesOutput
with field(s):directory_descriptions(Option<Vec::<DirectoryDescription>>)
:The list of available
DirectoryDescription
objects that were retrieved.It is possible that this list contains less than the number of items specified in the
Limit
member of the request. This occurs if there are less than the requested number of items left to retrieve, or if the limitations of the operation have been exceeded.next_token(Option<String>)
:If not null, more results are available. Pass this value for the
NextToken
parameter in a subsequent call toDescribeDirectories
to retrieve the next set of items.
- On failure, responds with
SdkError<DescribeDirectoriesError>
Source§impl Client
impl Client
Sourcepub fn describe_directory_data_access(
&self,
) -> DescribeDirectoryDataAccessFluentBuilder
pub fn describe_directory_data_access( &self, ) -> DescribeDirectoryDataAccessFluentBuilder
Constructs a fluent builder for the DescribeDirectoryDataAccess
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe directory identifier.
- On success, responds with
DescribeDirectoryDataAccessOutput
with field(s):data_access_status(Option<DataAccessStatus>)
:The current status of data access through the Directory Service Data API.
- On failure, responds with
SdkError<DescribeDirectoryDataAccessError>
Source§impl Client
impl Client
Sourcepub fn describe_domain_controllers(
&self,
) -> DescribeDomainControllersFluentBuilder
pub fn describe_domain_controllers( &self, ) -> DescribeDomainControllersFluentBuilder
Constructs a fluent builder for the DescribeDomainControllers
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier of the directory for which to retrieve the domain controller information.
domain_controller_ids(impl Into<String>)
/set_domain_controller_ids(Option<Vec::<String>>)
:
required: falseA list of identifiers for the domain controllers whose information will be provided.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe DescribeDomainControllers.NextToken value from a previous call to
DescribeDomainControllers
. Pass null if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of items to return.
- On success, responds with
DescribeDomainControllersOutput
with field(s):domain_controllers(Option<Vec::<DomainController>>)
:List of the
DomainController
objects that were retrieved.next_token(Option<String>)
:If not null, more results are available. Pass this value for the
NextToken
parameter in a subsequent call toDescribeDomainControllers
retrieve the next set of items.
- On failure, responds with
SdkError<DescribeDomainControllersError>
Source§impl Client
impl Client
Sourcepub fn describe_event_topics(&self) -> DescribeEventTopicsFluentBuilder
pub fn describe_event_topics(&self) -> DescribeEventTopicsFluentBuilder
Constructs a fluent builder for the DescribeEventTopics
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: falseThe Directory ID for which to get the list of associated Amazon SNS topics. If this member is null, associations for all Directory IDs are returned.
topic_names(impl Into<String>)
/set_topic_names(Option<Vec::<String>>)
:
required: falseA list of Amazon SNS topic names for which to obtain the information. If this member is null, all associations for the specified Directory ID are returned.
An empty list results in an
InvalidParameterException
being thrown.
- On success, responds with
DescribeEventTopicsOutput
with field(s):event_topics(Option<Vec::<EventTopic>>)
:A list of Amazon SNS topic names that receive status messages from the specified Directory ID.
- On failure, responds with
SdkError<DescribeEventTopicsError>
Source§impl Client
impl Client
Sourcepub fn describe_ldaps_settings(&self) -> DescribeLDAPSSettingsFluentBuilder
pub fn describe_ldaps_settings(&self) -> DescribeLDAPSSettingsFluentBuilder
Constructs a fluent builder for the DescribeLDAPSSettings
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory.
r#type(LdapsType)
/set_type(Option<LdapsType>)
:
required: falseThe type of LDAP security to enable. Currently only the value
Client
is supported.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe type of next token used for pagination.
limit(i32)
/set_limit(Option<i32>)
:
required: falseSpecifies the number of items that should be displayed on one page.
- On success, responds with
DescribeLdapsSettingsOutput
with field(s):ldaps_settings_info(Option<Vec::<LdapsSettingInfo>>)
:Information about LDAP security for the specified directory, including status of enablement, state last updated date time, and the reason for the state.
next_token(Option<String>)
:The next token used to retrieve the LDAPS settings if the number of setting types exceeds page limit and there is another page.
- On failure, responds with
SdkError<DescribeLDAPSSettingsError>
Source§impl Client
impl Client
Sourcepub fn describe_regions(&self) -> DescribeRegionsFluentBuilder
pub fn describe_regions(&self) -> DescribeRegionsFluentBuilder
Constructs a fluent builder for the DescribeRegions
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory.
region_name(impl Into<String>)
/set_region_name(Option<String>)
:
required: falseThe name of the Region. For example,
us-east-1
.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe
DescribeRegionsResult.NextToken
value from a previous call toDescribeRegions
. Pass null if this is the first call.
- On success, responds with
DescribeRegionsOutput
with field(s):regions_description(Option<Vec::<RegionDescription>>)
:List of Region information related to the directory for each replicated Region.
next_token(Option<String>)
:If not null, more results are available. Pass this value for the
NextToken
parameter in a subsequent call toDescribeRegions
to retrieve the next set of items.
- On failure, responds with
SdkError<DescribeRegionsError>
Source§impl Client
impl Client
Sourcepub fn describe_settings(&self) -> DescribeSettingsFluentBuilder
pub fn describe_settings(&self) -> DescribeSettingsFluentBuilder
Constructs a fluent builder for the DescribeSettings
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to retrieve information.
status(DirectoryConfigurationStatus)
/set_status(Option<DirectoryConfigurationStatus>)
:
required: falseThe status of the directory settings for which to retrieve information.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe
DescribeSettingsResult.NextToken
value from a previous call toDescribeSettings
. Pass null if this is the first call.
- On success, responds with
DescribeSettingsOutput
with field(s):directory_id(Option<String>)
:The identifier of the directory.
setting_entries(Option<Vec::<SettingEntry>>)
:The list of
SettingEntry
objects that were retrieved.It is possible that this list contains less than the number of items specified in the
Limit
member of the request. This occurs if there are less than the requested number of items left to retrieve, or if the limitations of the operation have been exceeded.next_token(Option<String>)
:If not null, token that indicates that more results are available. Pass this value for the
NextToken
parameter in a subsequent call toDescribeSettings
to retrieve the next set of items.
- On failure, responds with
SdkError<DescribeSettingsError>
Source§impl Client
impl Client
Constructs a fluent builder for the DescribeSharedDirectories
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
owner_directory_id(impl Into<String>)
/set_owner_directory_id(Option<String>)
:
required: trueReturns the identifier of the directory in the directory owner account.
shared_directory_ids(impl Into<String>)
/set_shared_directory_ids(Option<Vec::<String>>)
:
required: falseA list of identifiers of all shared directories in your account.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe
DescribeSharedDirectoriesResult.NextToken
value from a previous call toDescribeSharedDirectories
. Pass null if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseThe number of shared directories to return in the response object.
- On success, responds with
DescribeSharedDirectoriesOutput
with field(s):shared_directories(Option<Vec::<SharedDirectory>>)
:A list of all shared directories in your account.
next_token(Option<String>)
:If not null, token that indicates that more results are available. Pass this value for the
NextToken
parameter in a subsequent call toDescribeSharedDirectories
to retrieve the next set of items.
- On failure, responds with
SdkError<DescribeSharedDirectoriesError>
Source§impl Client
impl Client
Sourcepub fn describe_snapshots(&self) -> DescribeSnapshotsFluentBuilder
pub fn describe_snapshots(&self) -> DescribeSnapshotsFluentBuilder
Constructs a fluent builder for the DescribeSnapshots
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: falseThe identifier of the directory for which to retrieve snapshot information.
snapshot_ids(impl Into<String>)
/set_snapshot_ids(Option<Vec::<String>>)
:
required: falseA list of identifiers of the snapshots to obtain the information for. If this member is null or empty, all snapshots are returned using the Limit and NextToken members.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe DescribeSnapshotsResult.NextToken value from a previous call to
DescribeSnapshots
. Pass null if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of objects to return.
- On success, responds with
DescribeSnapshotsOutput
with field(s):snapshots(Option<Vec::<Snapshot>>)
:The list of
Snapshot
objects that were retrieved.It is possible that this list contains less than the number of items specified in the Limit member of the request. This occurs if there are less than the requested number of items left to retrieve, or if the limitations of the operation have been exceeded.
next_token(Option<String>)
:If not null, more results are available. Pass this value in the NextToken member of a subsequent call to
DescribeSnapshots
.
- On failure, responds with
SdkError<DescribeSnapshotsError>
Source§impl Client
impl Client
Sourcepub fn describe_trusts(&self) -> DescribeTrustsFluentBuilder
pub fn describe_trusts(&self) -> DescribeTrustsFluentBuilder
Constructs a fluent builder for the DescribeTrusts
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: falseThe Directory ID of the Amazon Web Services directory that is a part of the requested trust relationship.
trust_ids(impl Into<String>)
/set_trust_ids(Option<Vec::<String>>)
:
required: falseA list of identifiers of the trust relationships for which to obtain the information. If this member is null, all trust relationships that belong to the current account are returned.
An empty list results in an
InvalidParameterException
being thrown.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe DescribeTrustsResult.NextToken value from a previous call to
DescribeTrusts
. Pass null if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of objects to return.
- On success, responds with
DescribeTrustsOutput
with field(s):trusts(Option<Vec::<Trust>>)
:The list of Trust objects that were retrieved.
It is possible that this list contains less than the number of items specified in the Limit member of the request. This occurs if there are less than the requested number of items left to retrieve, or if the limitations of the operation have been exceeded.
next_token(Option<String>)
:If not null, more results are available. Pass this value for the NextToken parameter in a subsequent call to
DescribeTrusts
to retrieve the next set of items.
- On failure, responds with
SdkError<DescribeTrustsError>
Source§impl Client
impl Client
Sourcepub fn describe_update_directory(&self) -> DescribeUpdateDirectoryFluentBuilder
pub fn describe_update_directory(&self) -> DescribeUpdateDirectoryFluentBuilder
Constructs a fluent builder for the DescribeUpdateDirectory
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe unique identifier of the directory.
update_type(UpdateType)
/set_update_type(Option<UpdateType>)
:
required: trueThe type of updates you want to describe for the directory.
region_name(impl Into<String>)
/set_region_name(Option<String>)
:
required: falseThe name of the Region.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe
DescribeUpdateDirectoryResult
. NextToken value from a previous call toDescribeUpdateDirectory
. Pass null if this is the first call.
- On success, responds with
DescribeUpdateDirectoryOutput
with field(s):update_activities(Option<Vec::<UpdateInfoEntry>>)
:The list of update activities on a directory for the requested update type.
next_token(Option<String>)
:If not null, more results are available. Pass this value for the
NextToken
parameter.
- On failure, responds with
SdkError<DescribeUpdateDirectoryError>
Source§impl Client
impl Client
Sourcepub fn disable_client_authentication(
&self,
) -> DisableClientAuthenticationFluentBuilder
pub fn disable_client_authentication( &self, ) -> DisableClientAuthenticationFluentBuilder
Constructs a fluent builder for the DisableClientAuthentication
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory
r#type(ClientAuthenticationType)
/set_type(Option<ClientAuthenticationType>)
:
required: trueThe type of client authentication to disable. Currently the only parameter
“SmartCard”
is supported.
- On success, responds with
DisableClientAuthenticationOutput
- On failure, responds with
SdkError<DisableClientAuthenticationError>
Source§impl Client
impl Client
Sourcepub fn disable_directory_data_access(
&self,
) -> DisableDirectoryDataAccessFluentBuilder
pub fn disable_directory_data_access( &self, ) -> DisableDirectoryDataAccessFluentBuilder
Constructs a fluent builder for the DisableDirectoryDataAccess
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe directory identifier.
- On success, responds with
DisableDirectoryDataAccessOutput
- On failure, responds with
SdkError<DisableDirectoryDataAccessError>
Source§impl Client
impl Client
Sourcepub fn disable_ldaps(&self) -> DisableLDAPSFluentBuilder
pub fn disable_ldaps(&self) -> DisableLDAPSFluentBuilder
Constructs a fluent builder for the DisableLDAPS
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory.
r#type(LdapsType)
/set_type(Option<LdapsType>)
:
required: trueThe type of LDAP security to enable. Currently only the value
Client
is supported.
- On success, responds with
DisableLdapsOutput
- On failure, responds with
SdkError<DisableLDAPSError>
Source§impl Client
impl Client
Sourcepub fn disable_radius(&self) -> DisableRadiusFluentBuilder
pub fn disable_radius(&self) -> DisableRadiusFluentBuilder
Constructs a fluent builder for the DisableRadius
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to disable MFA.
- On success, responds with
DisableRadiusOutput
- On failure, responds with
SdkError<DisableRadiusError>
Source§impl Client
impl Client
Sourcepub fn disable_sso(&self) -> DisableSsoFluentBuilder
pub fn disable_sso(&self) -> DisableSsoFluentBuilder
Constructs a fluent builder for the DisableSso
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to disable single-sign on.
user_name(impl Into<String>)
/set_user_name(Option<String>)
:
required: falseThe username of an alternate account to use to disable single-sign on. This is only used for AD Connector directories. This account must have privileges to remove a service principal name.
If the AD Connector service account does not have privileges to remove a service principal name, you can specify an alternate account with the UserName and Password parameters. These credentials are only used to disable single sign-on and are not stored by the service. The AD Connector service account is not changed.
password(impl Into<String>)
/set_password(Option<String>)
:
required: falseThe password of an alternate account to use to disable single-sign on. This is only used for AD Connector directories. For more information, see the UserName parameter.
- On success, responds with
DisableSsoOutput
- On failure, responds with
SdkError<DisableSsoError>
Source§impl Client
impl Client
Sourcepub fn enable_client_authentication(
&self,
) -> EnableClientAuthenticationFluentBuilder
pub fn enable_client_authentication( &self, ) -> EnableClientAuthenticationFluentBuilder
Constructs a fluent builder for the EnableClientAuthentication
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the specified directory.
r#type(ClientAuthenticationType)
/set_type(Option<ClientAuthenticationType>)
:
required: trueThe type of client authentication to enable. Currently only the value
SmartCard
is supported. Smart card authentication in AD Connector requires that you enable Kerberos Constrained Delegation for the Service User to the LDAP service in your self-managed AD.
- On success, responds with
EnableClientAuthenticationOutput
- On failure, responds with
SdkError<EnableClientAuthenticationError>
Source§impl Client
impl Client
Sourcepub fn enable_directory_data_access(
&self,
) -> EnableDirectoryDataAccessFluentBuilder
pub fn enable_directory_data_access( &self, ) -> EnableDirectoryDataAccessFluentBuilder
Constructs a fluent builder for the EnableDirectoryDataAccess
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe directory identifier.
- On success, responds with
EnableDirectoryDataAccessOutput
- On failure, responds with
SdkError<EnableDirectoryDataAccessError>
Source§impl Client
impl Client
Sourcepub fn enable_ldaps(&self) -> EnableLDAPSFluentBuilder
pub fn enable_ldaps(&self) -> EnableLDAPSFluentBuilder
Constructs a fluent builder for the EnableLDAPS
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory.
r#type(LdapsType)
/set_type(Option<LdapsType>)
:
required: trueThe type of LDAP security to enable. Currently only the value
Client
is supported.
- On success, responds with
EnableLdapsOutput
- On failure, responds with
SdkError<EnableLDAPSError>
Source§impl Client
impl Client
Sourcepub fn enable_radius(&self) -> EnableRadiusFluentBuilder
pub fn enable_radius(&self) -> EnableRadiusFluentBuilder
Constructs a fluent builder for the EnableRadius
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to enable MFA.
radius_settings(RadiusSettings)
/set_radius_settings(Option<RadiusSettings>)
:
required: trueA
RadiusSettings
object that contains information about the RADIUS server.
- On success, responds with
EnableRadiusOutput
- On failure, responds with
SdkError<EnableRadiusError>
Source§impl Client
impl Client
Sourcepub fn enable_sso(&self) -> EnableSsoFluentBuilder
pub fn enable_sso(&self) -> EnableSsoFluentBuilder
Constructs a fluent builder for the EnableSso
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to enable single-sign on.
user_name(impl Into<String>)
/set_user_name(Option<String>)
:
required: falseThe username of an alternate account to use to enable single-sign on. This is only used for AD Connector directories. This account must have privileges to add a service principal name.
If the AD Connector service account does not have privileges to add a service principal name, you can specify an alternate account with the UserName and Password parameters. These credentials are only used to enable single sign-on and are not stored by the service. The AD Connector service account is not changed.
password(impl Into<String>)
/set_password(Option<String>)
:
required: falseThe password of an alternate account to use to enable single-sign on. This is only used for AD Connector directories. For more information, see the UserName parameter.
- On success, responds with
EnableSsoOutput
- On failure, responds with
SdkError<EnableSsoError>
Source§impl Client
impl Client
Sourcepub fn get_directory_limits(&self) -> GetDirectoryLimitsFluentBuilder
pub fn get_directory_limits(&self) -> GetDirectoryLimitsFluentBuilder
Constructs a fluent builder for the GetDirectoryLimits
operation.
- The fluent builder takes no input, just
send
it. - On success, responds with
GetDirectoryLimitsOutput
with field(s):directory_limits(Option<DirectoryLimits>)
:A
DirectoryLimits
object that contains the directory limits for the current Region.
- On failure, responds with
SdkError<GetDirectoryLimitsError>
Source§impl Client
impl Client
Sourcepub fn get_snapshot_limits(&self) -> GetSnapshotLimitsFluentBuilder
pub fn get_snapshot_limits(&self) -> GetSnapshotLimitsFluentBuilder
Constructs a fluent builder for the GetSnapshotLimits
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueContains the identifier of the directory to obtain the limits for.
- On success, responds with
GetSnapshotLimitsOutput
with field(s):snapshot_limits(Option<SnapshotLimits>)
:A
SnapshotLimits
object that contains the manual snapshot limits for the specified directory.
- On failure, responds with
SdkError<GetSnapshotLimitsError>
Source§impl Client
impl Client
Sourcepub fn list_certificates(&self) -> ListCertificatesFluentBuilder
pub fn list_certificates(&self) -> ListCertificatesFluentBuilder
Constructs a fluent builder for the ListCertificates
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseA token for requesting another page of certificates if the
NextToken
response element indicates that more certificates are available. Use the value of the returnedNextToken
element in your request until the token comes back asnull
. Passnull
if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseThe number of items that should show up on one page
- On success, responds with
ListCertificatesOutput
with field(s):next_token(Option<String>)
:Indicates whether another page of certificates is available when the number of available certificates exceeds the page limit.
certificates_info(Option<Vec::<CertificateInfo>>)
:A list of certificates with basic details including certificate ID, certificate common name, certificate state.
- On failure, responds with
SdkError<ListCertificatesError>
Source§impl Client
impl Client
Sourcepub fn list_ip_routes(&self) -> ListIpRoutesFluentBuilder
pub fn list_ip_routes(&self) -> ListIpRoutesFluentBuilder
Constructs a fluent builder for the ListIpRoutes
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier (ID) of the directory for which you want to retrieve the IP addresses.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe ListIpRoutes.NextToken value from a previous call to
ListIpRoutes
. Pass null if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseMaximum number of items to return. If this value is zero, the maximum number of items is specified by the limitations of the operation.
- On success, responds with
ListIpRoutesOutput
with field(s):ip_routes_info(Option<Vec::<IpRouteInfo>>)
:A list of
IpRoute
s.next_token(Option<String>)
:If not null, more results are available. Pass this value for the NextToken parameter in a subsequent call to
ListIpRoutes
to retrieve the next set of items.
- On failure, responds with
SdkError<ListIpRoutesError>
Source§impl Client
impl Client
Sourcepub fn list_log_subscriptions(&self) -> ListLogSubscriptionsFluentBuilder
pub fn list_log_subscriptions(&self) -> ListLogSubscriptionsFluentBuilder
Constructs a fluent builder for the ListLogSubscriptions
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: falseIf a DirectoryID is provided, lists only the log subscription associated with that directory. If no DirectoryId is provided, lists all log subscriptions associated with your Amazon Web Services account. If there are no log subscriptions for the Amazon Web Services account or the directory, an empty list will be returned.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe token for the next set of items to return.
limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of items returned.
- On success, responds with
ListLogSubscriptionsOutput
with field(s):log_subscriptions(Option<Vec::<LogSubscription>>)
:A list of active
LogSubscription
objects for calling the Amazon Web Services account.next_token(Option<String>)
:The token for the next set of items to return.
- On failure, responds with
SdkError<ListLogSubscriptionsError>
Source§impl Client
impl Client
Sourcepub fn list_schema_extensions(&self) -> ListSchemaExtensionsFluentBuilder
pub fn list_schema_extensions(&self) -> ListSchemaExtensionsFluentBuilder
Constructs a fluent builder for the ListSchemaExtensions
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory from which to retrieve the schema extension information.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe
ListSchemaExtensions.NextToken
value from a previous call toListSchemaExtensions
. Pass null if this is the first call.limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of items to return.
- On success, responds with
ListSchemaExtensionsOutput
with field(s):schema_extensions_info(Option<Vec::<SchemaExtensionInfo>>)
:Information about the schema extensions applied to the directory.
next_token(Option<String>)
:If not null, more results are available. Pass this value for the
NextToken
parameter in a subsequent call toListSchemaExtensions
to retrieve the next set of items.
- On failure, responds with
SdkError<ListSchemaExtensionsError>
Source§impl Client
impl Client
Constructs a fluent builder for the ListTagsForResource
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
resource_id(impl Into<String>)
/set_resource_id(Option<String>)
:
required: trueIdentifier (ID) of the directory for which you want to retrieve tags.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseReserved for future use.
limit(i32)
/set_limit(Option<i32>)
:
required: falseReserved for future use.
- On success, responds with
ListTagsForResourceOutput
with field(s):tags(Option<Vec::<Tag>>)
:List of tags returned by the ListTagsForResource operation.
next_token(Option<String>)
:Reserved for future use.
- On failure, responds with
SdkError<ListTagsForResourceError>
Source§impl Client
impl Client
Sourcepub fn register_certificate(&self) -> RegisterCertificateFluentBuilder
pub fn register_certificate(&self) -> RegisterCertificateFluentBuilder
Constructs a fluent builder for the RegisterCertificate
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory.
certificate_data(impl Into<String>)
/set_certificate_data(Option<String>)
:
required: trueThe certificate PEM string that needs to be registered.
r#type(CertificateType)
/set_type(Option<CertificateType>)
:
required: falseThe function that the registered certificate performs. Valid values include
ClientLDAPS
orClientCertAuth
. The default value isClientLDAPS
.client_cert_auth_settings(ClientCertAuthSettings)
/set_client_cert_auth_settings(Option<ClientCertAuthSettings>)
:
required: falseA
ClientCertAuthSettings
object that contains client certificate authentication settings.
- On success, responds with
RegisterCertificateOutput
with field(s):certificate_id(Option<String>)
:The identifier of the certificate.
- On failure, responds with
SdkError<RegisterCertificateError>
Source§impl Client
impl Client
Sourcepub fn register_event_topic(&self) -> RegisterEventTopicFluentBuilder
pub fn register_event_topic(&self) -> RegisterEventTopicFluentBuilder
Constructs a fluent builder for the RegisterEventTopic
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe Directory ID that will publish status messages to the Amazon SNS topic.
topic_name(impl Into<String>)
/set_topic_name(Option<String>)
:
required: trueThe Amazon SNS topic name to which the directory will publish status messages. This Amazon SNS topic must be in the same region as the specified Directory ID.
- On success, responds with
RegisterEventTopicOutput
- On failure, responds with
SdkError<RegisterEventTopicError>
Source§impl Client
impl Client
Constructs a fluent builder for the RejectSharedDirectory
operation.
- The fluent builder is configurable:
shared_directory_id(impl Into<String>)
/set_shared_directory_id(Option<String>)
:
required: trueIdentifier of the shared directory in the directory consumer account. This identifier is different for each directory owner account.
- On success, responds with
RejectSharedDirectoryOutput
with field(s):shared_directory_id(Option<String>)
:Identifier of the shared directory in the directory consumer account.
- On failure, responds with
SdkError<RejectSharedDirectoryError>
Source§impl Client
impl Client
Sourcepub fn remove_ip_routes(&self) -> RemoveIpRoutesFluentBuilder
pub fn remove_ip_routes(&self) -> RemoveIpRoutesFluentBuilder
Constructs a fluent builder for the RemoveIpRoutes
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier (ID) of the directory from which you want to remove the IP addresses.
cidr_ips(impl Into<String>)
/set_cidr_ips(Option<Vec::<String>>)
:
required: trueIP address blocks that you want to remove.
- On success, responds with
RemoveIpRoutesOutput
- On failure, responds with
SdkError<RemoveIpRoutesError>
Source§impl Client
impl Client
Sourcepub fn remove_region(&self) -> RemoveRegionFluentBuilder
pub fn remove_region(&self) -> RemoveRegionFluentBuilder
Constructs a fluent builder for the RemoveRegion
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which you want to remove Region replication.
- On success, responds with
RemoveRegionOutput
- On failure, responds with
SdkError<RemoveRegionError>
Source§impl Client
impl Client
Constructs a fluent builder for the RemoveTagsFromResource
operation.
- The fluent builder is configurable:
resource_id(impl Into<String>)
/set_resource_id(Option<String>)
:
required: trueIdentifier (ID) of the directory from which to remove the tag.
tag_keys(impl Into<String>)
/set_tag_keys(Option<Vec::<String>>)
:
required: trueThe tag key (name) of the tag to be removed.
- On success, responds with
RemoveTagsFromResourceOutput
- On failure, responds with
SdkError<RemoveTagsFromResourceError>
Source§impl Client
impl Client
Sourcepub fn reset_user_password(&self) -> ResetUserPasswordFluentBuilder
pub fn reset_user_password(&self) -> ResetUserPasswordFluentBuilder
Constructs a fluent builder for the ResetUserPassword
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier of the Managed Microsoft AD or Simple AD directory in which the user resides.
user_name(impl Into<String>)
/set_user_name(Option<String>)
:
required: trueThe user name of the user whose password will be reset.
new_password(impl Into<String>)
/set_new_password(Option<String>)
:
required: trueThe new password that will be reset.
- On success, responds with
ResetUserPasswordOutput
- On failure, responds with
SdkError<ResetUserPasswordError>
Source§impl Client
impl Client
Sourcepub fn restore_from_snapshot(&self) -> RestoreFromSnapshotFluentBuilder
pub fn restore_from_snapshot(&self) -> RestoreFromSnapshotFluentBuilder
Constructs a fluent builder for the RestoreFromSnapshot
operation.
- The fluent builder is configurable:
snapshot_id(impl Into<String>)
/set_snapshot_id(Option<String>)
:
required: trueThe identifier of the snapshot to restore from.
- On success, responds with
RestoreFromSnapshotOutput
- On failure, responds with
SdkError<RestoreFromSnapshotError>
Source§impl Client
impl Client
Constructs a fluent builder for the ShareDirectory
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier of the Managed Microsoft AD directory that you want to share with other Amazon Web Services accounts.
share_notes(impl Into<String>)
/set_share_notes(Option<String>)
:
required: falseA directory share request that is sent by the directory owner to the directory consumer. The request includes a typed message to help the directory consumer administrator determine whether to approve or reject the share invitation.
share_target(ShareTarget)
/set_share_target(Option<ShareTarget>)
:
required: trueIdentifier for the directory consumer account with whom the directory is to be shared.
share_method(ShareMethod)
/set_share_method(Option<ShareMethod>)
:
required: trueThe method used when sharing a directory to determine whether the directory should be shared within your Amazon Web Services organization (
ORGANIZATIONS
) or with any Amazon Web Services account by sending a directory sharing request (HANDSHAKE
).
- On success, responds with
ShareDirectoryOutput
with field(s):shared_directory_id(Option<String>)
:Identifier of the directory that is stored in the directory consumer account that is shared from the specified directory (
DirectoryId
).
- On failure, responds with
SdkError<ShareDirectoryError>
Source§impl Client
impl Client
Sourcepub fn start_schema_extension(&self) -> StartSchemaExtensionFluentBuilder
pub fn start_schema_extension(&self) -> StartSchemaExtensionFluentBuilder
Constructs a fluent builder for the StartSchemaExtension
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which the schema extension will be applied to.
create_snapshot_before_schema_extension(bool)
/set_create_snapshot_before_schema_extension(Option<bool>)
:
required: trueIf true, creates a snapshot of the directory before applying the schema extension.
ldif_content(impl Into<String>)
/set_ldif_content(Option<String>)
:
required: trueThe LDIF file represented as a string. To construct the LdifContent string, precede each line as it would be formatted in an ldif file with \n. See the example request below for more details. The file size can be no larger than 1MB.
description(impl Into<String>)
/set_description(Option<String>)
:
required: trueA description of the schema extension.
- On success, responds with
StartSchemaExtensionOutput
with field(s):schema_extension_id(Option<String>)
:The identifier of the schema extension that will be applied.
- On failure, responds with
SdkError<StartSchemaExtensionError>
Source§impl Client
impl Client
Constructs a fluent builder for the UnshareDirectory
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the Managed Microsoft AD directory that you want to stop sharing.
unshare_target(UnshareTarget)
/set_unshare_target(Option<UnshareTarget>)
:
required: trueIdentifier for the directory consumer account with whom the directory has to be unshared.
- On success, responds with
UnshareDirectoryOutput
with field(s):shared_directory_id(Option<String>)
:Identifier of the directory stored in the directory consumer account that is to be unshared from the specified directory (
DirectoryId
).
- On failure, responds with
SdkError<UnshareDirectoryError>
Source§impl Client
impl Client
Sourcepub fn update_conditional_forwarder(
&self,
) -> UpdateConditionalForwarderFluentBuilder
pub fn update_conditional_forwarder( &self, ) -> UpdateConditionalForwarderFluentBuilder
Constructs a fluent builder for the UpdateConditionalForwarder
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe directory ID of the Amazon Web Services directory for which to update the conditional forwarder.
remote_domain_name(impl Into<String>)
/set_remote_domain_name(Option<String>)
:
required: trueThe fully qualified domain name (FQDN) of the remote domain with which you will set up a trust relationship.
dns_ip_addrs(impl Into<String>)
/set_dns_ip_addrs(Option<Vec::<String>>)
:
required: trueThe updated IP addresses of the remote DNS server associated with the conditional forwarder.
- On success, responds with
UpdateConditionalForwarderOutput
- On failure, responds with
SdkError<UpdateConditionalForwarderError>
Source§impl Client
impl Client
Sourcepub fn update_directory_setup(&self) -> UpdateDirectorySetupFluentBuilder
pub fn update_directory_setup(&self) -> UpdateDirectorySetupFluentBuilder
Constructs a fluent builder for the UpdateDirectorySetup
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory on which you want to perform the update.
update_type(UpdateType)
/set_update_type(Option<UpdateType>)
:
required: trueThe type of update that needs to be performed on the directory. For example, OS.
os_update_settings(OsUpdateSettings)
/set_os_update_settings(Option<OsUpdateSettings>)
:
required: falseThe settings for the OS update that needs to be performed on the directory.
create_snapshot_before_update(bool)
/set_create_snapshot_before_update(Option<bool>)
:
required: falseThe boolean that specifies if a snapshot for the directory needs to be taken before updating the directory.
- On success, responds with
UpdateDirectorySetupOutput
- On failure, responds with
SdkError<UpdateDirectorySetupError>
Source§impl Client
impl Client
Sourcepub fn update_number_of_domain_controllers(
&self,
) -> UpdateNumberOfDomainControllersFluentBuilder
pub fn update_number_of_domain_controllers( &self, ) -> UpdateNumberOfDomainControllersFluentBuilder
Constructs a fluent builder for the UpdateNumberOfDomainControllers
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueIdentifier of the directory to which the domain controllers will be added or removed.
desired_number(i32)
/set_desired_number(Option<i32>)
:
required: trueThe number of domain controllers desired in the directory.
- On success, responds with
UpdateNumberOfDomainControllersOutput
- On failure, responds with
SdkError<UpdateNumberOfDomainControllersError>
Source§impl Client
impl Client
Sourcepub fn update_radius(&self) -> UpdateRadiusFluentBuilder
pub fn update_radius(&self) -> UpdateRadiusFluentBuilder
Constructs a fluent builder for the UpdateRadius
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to update the RADIUS server information.
radius_settings(RadiusSettings)
/set_radius_settings(Option<RadiusSettings>)
:
required: trueA
RadiusSettings
object that contains information about the RADIUS server.
- On success, responds with
UpdateRadiusOutput
- On failure, responds with
SdkError<UpdateRadiusError>
Source§impl Client
impl Client
Sourcepub fn update_settings(&self) -> UpdateSettingsFluentBuilder
pub fn update_settings(&self) -> UpdateSettingsFluentBuilder
Constructs a fluent builder for the UpdateSettings
operation.
- The fluent builder is configurable:
directory_id(impl Into<String>)
/set_directory_id(Option<String>)
:
required: trueThe identifier of the directory for which to update settings.
settings(Setting)
/set_settings(Option<Vec::<Setting>>)
:
required: trueThe list of
Setting
objects.
- On success, responds with
UpdateSettingsOutput
with field(s):directory_id(Option<String>)
:The identifier of the directory.
- On failure, responds with
SdkError<UpdateSettingsError>
Source§impl Client
impl Client
Sourcepub fn update_trust(&self) -> UpdateTrustFluentBuilder
pub fn update_trust(&self) -> UpdateTrustFluentBuilder
Constructs a fluent builder for the UpdateTrust
operation.
- The fluent builder is configurable:
trust_id(impl Into<String>)
/set_trust_id(Option<String>)
:
required: trueIdentifier of the trust relationship.
selective_auth(SelectiveAuth)
/set_selective_auth(Option<SelectiveAuth>)
:
required: falseUpdates selective authentication for the trust.
- On success, responds with
UpdateTrustOutput
with field(s):request_id(Option<String>)
:The Amazon Web Services request identifier.
trust_id(Option<String>)
:Identifier of the trust relationship.
- On failure, responds with
SdkError<UpdateTrustError>
Source§impl Client
impl Client
Sourcepub fn verify_trust(&self) -> VerifyTrustFluentBuilder
pub fn verify_trust(&self) -> VerifyTrustFluentBuilder
Constructs a fluent builder for the VerifyTrust
operation.
- The fluent builder is configurable:
trust_id(impl Into<String>)
/set_trust_id(Option<String>)
:
required: trueThe unique Trust ID of the trust relationship to verify.
- On success, responds with
VerifyTrustOutput
with field(s):trust_id(Option<String>)
:The unique Trust ID of the trust relationship that was verified.
- On failure, responds with
SdkError<VerifyTrustError>
Source§impl Client
impl Client
Sourcepub fn from_conf(conf: Config) -> Self
pub fn from_conf(conf: Config) -> Self
Creates a new client from the service Config
.
§Panics
This method will panic in the following cases:
- Retries or timeouts are enabled without a
sleep_impl
configured. - Identity caching is enabled without a
sleep_impl
andtime_source
configured. - No
behavior_version
is provided.
The panic message for each of these will have instructions on how to resolve them.
Source§impl Client
impl Client
Sourcepub fn new(sdk_config: &SdkConfig) -> Self
pub fn new(sdk_config: &SdkConfig) -> Self
Creates a new client from an SDK Config.
§Panics
- This method will panic if the
sdk_config
is missing an async sleep implementation. If you experience this panic, set thesleep_impl
on the Config passed into this function to fix it. - This method will panic if the
sdk_config
is missing an HTTP connector. If you experience this panic, set thehttp_connector
on the Config passed into this function to fix it. - This method will panic if no
BehaviorVersion
is provided. If you experience this panic, setbehavior_version
on the Config or enable thebehavior-version-latest
Cargo feature.
Trait Implementations§
Auto Trait Implementations§
impl Freeze for Client
impl !RefUnwindSafe for Client
impl Send for Client
impl Sync for Client
impl Unpin for Client
impl !UnwindSafe for Client
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);