pub struct CreateAccessEntryFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to CreateAccessEntry
.
Creates an access entry.
An access entry allows an IAM principal to access your cluster. Access entries can replace the need to maintain entries in the aws-auth
ConfigMap
for authentication. You have the following options for authorizing an IAM principal to access Kubernetes objects on your cluster: Kubernetes role-based access control (RBAC), Amazon EKS, or both. Kubernetes RBAC authorization requires you to create and manage Kubernetes Role
, ClusterRole
, RoleBinding
, and ClusterRoleBinding
objects, in addition to managing access entries. If you use Amazon EKS authorization exclusively, you don't need to create and manage Kubernetes Role
, ClusterRole
, RoleBinding
, and ClusterRoleBinding
objects.
For more information about access entries, see Access entries in the Amazon EKS User Guide.
Implementations§
Source§impl CreateAccessEntryFluentBuilder
impl CreateAccessEntryFluentBuilder
Sourcepub fn as_input(&self) -> &CreateAccessEntryInputBuilder
pub fn as_input(&self) -> &CreateAccessEntryInputBuilder
Access the CreateAccessEntry as a reference.
Sourcepub async fn send(
self,
) -> Result<CreateAccessEntryOutput, SdkError<CreateAccessEntryError, HttpResponse>>
pub async fn send( self, ) -> Result<CreateAccessEntryOutput, SdkError<CreateAccessEntryError, HttpResponse>>
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
Sourcepub fn customize(
self,
) -> CustomizableOperation<CreateAccessEntryOutput, CreateAccessEntryError, Self>
pub fn customize( self, ) -> CustomizableOperation<CreateAccessEntryOutput, CreateAccessEntryError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
Sourcepub fn cluster_name(self, input: impl Into<String>) -> Self
pub fn cluster_name(self, input: impl Into<String>) -> Self
The name of your cluster.
Sourcepub fn set_cluster_name(self, input: Option<String>) -> Self
pub fn set_cluster_name(self, input: Option<String>) -> Self
The name of your cluster.
Sourcepub fn get_cluster_name(&self) -> &Option<String>
pub fn get_cluster_name(&self) -> &Option<String>
The name of your cluster.
Sourcepub fn principal_arn(self, input: impl Into<String>) -> Self
pub fn principal_arn(self, input: impl Into<String>) -> Self
The ARN of the IAM principal for the AccessEntry
. You can specify one ARN for each access entry. You can't specify the same ARN in more than one access entry. This value can't be changed after access entry creation.
The valid principals differ depending on the type of the access entry in the type
field. For STANDARD
access entries, you can use every IAM principal type. For nodes (EC2
(for EKS Auto Mode), EC2_LINUX
, EC2_WINDOWS
, FARGATE_LINUX
, and HYBRID_LINUX
), the only valid ARN is IAM roles. You can't use the STS session principal type with access entries because this is a temporary principal for each session and not a permanent identity that can be assigned permissions.
IAM best practices recommend using IAM roles with temporary credentials, rather than IAM users with long-term credentials.
Sourcepub fn set_principal_arn(self, input: Option<String>) -> Self
pub fn set_principal_arn(self, input: Option<String>) -> Self
The ARN of the IAM principal for the AccessEntry
. You can specify one ARN for each access entry. You can't specify the same ARN in more than one access entry. This value can't be changed after access entry creation.
The valid principals differ depending on the type of the access entry in the type
field. For STANDARD
access entries, you can use every IAM principal type. For nodes (EC2
(for EKS Auto Mode), EC2_LINUX
, EC2_WINDOWS
, FARGATE_LINUX
, and HYBRID_LINUX
), the only valid ARN is IAM roles. You can't use the STS session principal type with access entries because this is a temporary principal for each session and not a permanent identity that can be assigned permissions.
IAM best practices recommend using IAM roles with temporary credentials, rather than IAM users with long-term credentials.
Sourcepub fn get_principal_arn(&self) -> &Option<String>
pub fn get_principal_arn(&self) -> &Option<String>
The ARN of the IAM principal for the AccessEntry
. You can specify one ARN for each access entry. You can't specify the same ARN in more than one access entry. This value can't be changed after access entry creation.
The valid principals differ depending on the type of the access entry in the type
field. For STANDARD
access entries, you can use every IAM principal type. For nodes (EC2
(for EKS Auto Mode), EC2_LINUX
, EC2_WINDOWS
, FARGATE_LINUX
, and HYBRID_LINUX
), the only valid ARN is IAM roles. You can't use the STS session principal type with access entries because this is a temporary principal for each session and not a permanent identity that can be assigned permissions.
IAM best practices recommend using IAM roles with temporary credentials, rather than IAM users with long-term credentials.
Sourcepub fn kubernetes_groups(self, input: impl Into<String>) -> Self
pub fn kubernetes_groups(self, input: impl Into<String>) -> Self
Appends an item to kubernetesGroups
.
To override the contents of this collection use set_kubernetes_groups
.
The value for name
that you've specified for kind: Group
as a subject
in a Kubernetes RoleBinding
or ClusterRoleBinding
object. Amazon EKS doesn't confirm that the value for name
exists in any bindings on your cluster. You can specify one or more names.
Kubernetes authorizes the principalArn
of the access entry to access any cluster objects that you've specified in a Kubernetes Role
or ClusterRole
object that is also specified in a binding's roleRef
. For more information about creating Kubernetes RoleBinding
, ClusterRoleBinding
, Role
, or ClusterRole
objects, see Using RBAC Authorization in the Kubernetes documentation.
If you want Amazon EKS to authorize the principalArn
(instead of, or in addition to Kubernetes authorizing the principalArn
), you can associate one or more access policies to the access entry using AssociateAccessPolicy
. If you associate any access policies, the principalARN
has all permissions assigned in the associated access policies and all permissions in any Kubernetes Role
or ClusterRole
objects that the group names are bound to.
Sourcepub fn set_kubernetes_groups(self, input: Option<Vec<String>>) -> Self
pub fn set_kubernetes_groups(self, input: Option<Vec<String>>) -> Self
The value for name
that you've specified for kind: Group
as a subject
in a Kubernetes RoleBinding
or ClusterRoleBinding
object. Amazon EKS doesn't confirm that the value for name
exists in any bindings on your cluster. You can specify one or more names.
Kubernetes authorizes the principalArn
of the access entry to access any cluster objects that you've specified in a Kubernetes Role
or ClusterRole
object that is also specified in a binding's roleRef
. For more information about creating Kubernetes RoleBinding
, ClusterRoleBinding
, Role
, or ClusterRole
objects, see Using RBAC Authorization in the Kubernetes documentation.
If you want Amazon EKS to authorize the principalArn
(instead of, or in addition to Kubernetes authorizing the principalArn
), you can associate one or more access policies to the access entry using AssociateAccessPolicy
. If you associate any access policies, the principalARN
has all permissions assigned in the associated access policies and all permissions in any Kubernetes Role
or ClusterRole
objects that the group names are bound to.
Sourcepub fn get_kubernetes_groups(&self) -> &Option<Vec<String>>
pub fn get_kubernetes_groups(&self) -> &Option<Vec<String>>
The value for name
that you've specified for kind: Group
as a subject
in a Kubernetes RoleBinding
or ClusterRoleBinding
object. Amazon EKS doesn't confirm that the value for name
exists in any bindings on your cluster. You can specify one or more names.
Kubernetes authorizes the principalArn
of the access entry to access any cluster objects that you've specified in a Kubernetes Role
or ClusterRole
object that is also specified in a binding's roleRef
. For more information about creating Kubernetes RoleBinding
, ClusterRoleBinding
, Role
, or ClusterRole
objects, see Using RBAC Authorization in the Kubernetes documentation.
If you want Amazon EKS to authorize the principalArn
(instead of, or in addition to Kubernetes authorizing the principalArn
), you can associate one or more access policies to the access entry using AssociateAccessPolicy
. If you associate any access policies, the principalARN
has all permissions assigned in the associated access policies and all permissions in any Kubernetes Role
or ClusterRole
objects that the group names are bound to.
Adds a key-value pair to tags
.
To override the contents of this collection use set_tags
.
Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or Amazon Web Services resources.
Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or Amazon Web Services resources.
Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or Amazon Web Services resources.
Sourcepub fn client_request_token(self, input: impl Into<String>) -> Self
pub fn client_request_token(self, input: impl Into<String>) -> Self
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
Sourcepub fn set_client_request_token(self, input: Option<String>) -> Self
pub fn set_client_request_token(self, input: Option<String>) -> Self
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
Sourcepub fn get_client_request_token(&self) -> &Option<String>
pub fn get_client_request_token(&self) -> &Option<String>
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
Sourcepub fn username(self, input: impl Into<String>) -> Self
pub fn username(self, input: impl Into<String>) -> Self
The username to authenticate to Kubernetes with. We recommend not specifying a username and letting Amazon EKS specify it for you. For more information about the value Amazon EKS specifies for you, or constraints before specifying your own username, see Creating access entries in the Amazon EKS User Guide.
Sourcepub fn set_username(self, input: Option<String>) -> Self
pub fn set_username(self, input: Option<String>) -> Self
The username to authenticate to Kubernetes with. We recommend not specifying a username and letting Amazon EKS specify it for you. For more information about the value Amazon EKS specifies for you, or constraints before specifying your own username, see Creating access entries in the Amazon EKS User Guide.
Sourcepub fn get_username(&self) -> &Option<String>
pub fn get_username(&self) -> &Option<String>
The username to authenticate to Kubernetes with. We recommend not specifying a username and letting Amazon EKS specify it for you. For more information about the value Amazon EKS specifies for you, or constraints before specifying your own username, see Creating access entries in the Amazon EKS User Guide.
Sourcepub fn type(self, input: impl Into<String>) -> Self
pub fn type(self, input: impl Into<String>) -> Self
The type of the new access entry. Valid values are STANDARD
, FARGATE_LINUX
, EC2_LINUX
, EC2_WINDOWS
, EC2
(for EKS Auto Mode), HYBRID_LINUX
, and HYPERPOD_LINUX
.
If the principalArn
is for an IAM role that's used for self-managed Amazon EC2 nodes, specify EC2_LINUX
or EC2_WINDOWS
. Amazon EKS grants the necessary permissions to the node for you. If the principalArn
is for any other purpose, specify STANDARD
. If you don't specify a value, Amazon EKS sets the value to STANDARD
. If you have the access mode of the cluster set to API_AND_CONFIG_MAP
, it's unnecessary to create access entries for IAM roles used with Fargate profiles or managed Amazon EC2 nodes, because Amazon EKS creates entries in the aws-auth
ConfigMap
for the roles. You can't change this value once you've created the access entry.
If you set the value to EC2_LINUX
or EC2_WINDOWS
, you can't specify values for kubernetesGroups
, or associate an AccessPolicy
to the access entry.
Sourcepub fn set_type(self, input: Option<String>) -> Self
pub fn set_type(self, input: Option<String>) -> Self
The type of the new access entry. Valid values are STANDARD
, FARGATE_LINUX
, EC2_LINUX
, EC2_WINDOWS
, EC2
(for EKS Auto Mode), HYBRID_LINUX
, and HYPERPOD_LINUX
.
If the principalArn
is for an IAM role that's used for self-managed Amazon EC2 nodes, specify EC2_LINUX
or EC2_WINDOWS
. Amazon EKS grants the necessary permissions to the node for you. If the principalArn
is for any other purpose, specify STANDARD
. If you don't specify a value, Amazon EKS sets the value to STANDARD
. If you have the access mode of the cluster set to API_AND_CONFIG_MAP
, it's unnecessary to create access entries for IAM roles used with Fargate profiles or managed Amazon EC2 nodes, because Amazon EKS creates entries in the aws-auth
ConfigMap
for the roles. You can't change this value once you've created the access entry.
If you set the value to EC2_LINUX
or EC2_WINDOWS
, you can't specify values for kubernetesGroups
, or associate an AccessPolicy
to the access entry.
Sourcepub fn get_type(&self) -> &Option<String>
pub fn get_type(&self) -> &Option<String>
The type of the new access entry. Valid values are STANDARD
, FARGATE_LINUX
, EC2_LINUX
, EC2_WINDOWS
, EC2
(for EKS Auto Mode), HYBRID_LINUX
, and HYPERPOD_LINUX
.
If the principalArn
is for an IAM role that's used for self-managed Amazon EC2 nodes, specify EC2_LINUX
or EC2_WINDOWS
. Amazon EKS grants the necessary permissions to the node for you. If the principalArn
is for any other purpose, specify STANDARD
. If you don't specify a value, Amazon EKS sets the value to STANDARD
. If you have the access mode of the cluster set to API_AND_CONFIG_MAP
, it's unnecessary to create access entries for IAM roles used with Fargate profiles or managed Amazon EC2 nodes, because Amazon EKS creates entries in the aws-auth
ConfigMap
for the roles. You can't change this value once you've created the access entry.
If you set the value to EC2_LINUX
or EC2_WINDOWS
, you can't specify values for kubernetesGroups
, or associate an AccessPolicy
to the access entry.
Trait Implementations§
Source§impl Clone for CreateAccessEntryFluentBuilder
impl Clone for CreateAccessEntryFluentBuilder
Source§fn clone(&self) -> CreateAccessEntryFluentBuilder
fn clone(&self) -> CreateAccessEntryFluentBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for CreateAccessEntryFluentBuilder
impl !RefUnwindSafe for CreateAccessEntryFluentBuilder
impl Send for CreateAccessEntryFluentBuilder
impl Sync for CreateAccessEntryFluentBuilder
impl Unpin for CreateAccessEntryFluentBuilder
impl !UnwindSafe for CreateAccessEntryFluentBuilder
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);